API-ul de randare AI Graydient
Dacă construiești o aplicație, un instrument intern sau un pipeline de randare, Graydient îți oferă modele open de imagini, video și LLM pe GPU-uri dedicate, printr-un singur API, la un preț fix lunar.
Ce plan îl include
API-ul personal vine doar cu Video Max. Images și Video Plus nu includ acces API. Poți face upgrade, downgrade sau anula oricând în portal de facturare, cu taxe proporționale. Prețurile planului Business și API sunt la business.graydient.ai.
API-ul personal este o cheie pentru un singur utilizator uman, iar traficul automatizat nu este permis pe niciun plan personal. Asta înseamnă fără boți, scripturi, programatori, joburi batch, scrapers, aplicații multi-utilizator sau acces revândut. Are limită de rată: păstrează aproximativ un apel la fiecare 10 secunde. Cheile care trimit trafic automatizat sau excesiv sunt revocate fără notificare.
Construirea unui produs multi-utilizator sau white-label
Utilizatorii virtuali și login-ul white-label sunt funcții de nivel business pentru aplicații lansate, adică produse cu mulți utilizatori. Funcționează pe API-ul personal, deci poți construi și testa fluxuri multi-utilizator și white-label pe Video Max în timpul dezvoltării.
Lansarea unui produs multi-utilizator, trafic automatizat sau acces revândut necesită planul Business: un server GPU dedicat. business.graydient.ai explică ce este inclus, listează prețurile și îl vinde.
| API personal (Video Max) | Implementare business | |
|---|---|---|
| Utilizatori | Un utilizator (tu) | Utilizatorii produsului tău |
| Revânzare | Nu este permisă | Permisă |
| Utilizatori virtuali și autentificare white-label | Construiește și testează | Lansează live |
| Cum să-l obții | Abonează-te la Video Max | Server GPU dedicat sau acord de afaceri |
Cum funcționează API-ul
Versiunea curentă este V3, la https://cloud.graydient.ai/api/v3/. Urmează specificația JSON:API: trimite și acceptă application/vnd.api+json, autentifică-te cu un token HTTP Bearer standard de pe pagina ta de tokenuri API și citește rezultatele dintr-un obiect data cu un membru attributes.
Redarea este asincronă. Trimiți un POST la POST /api/v3/render/ cu un prompt și un callback_url obligatoriu. Graydient răspunde imediat cu un render_hash plus timpi estimați de așteptare și redare. Când jobul se termină, trimite rezultatele prin POST la webhook-ul tău. Câmpurile opționale includ:
- error_url: un webhook pentru erori
- init_image și mask_image: pentru image-to-image și inpainting
- placeholders: URL-uri de imagini denumite pentru modurile ControlNet sau adaptoare IP
- progressive_return: un callback per imagine
- session_id: corelează redările cu propriii tăi utilizatori
Fluxurile de lucru rulează prin același endpoint cu o comandă workflow în prompt.
Status fără polling: GET GET /api/v3/render/{render_hash} returnează statusul unei redări, dar documentația recomandă să nu faci polling. Folosește webhook-ul sau stream-ul WebSocket la wss://cloud.graydient.ai/render-events/{render_hash}, care trimite evenimentele started, image_done, done și error.
Alte familii de endpointuri
- Chat: chat LLM cu o persoană. Răspunsurile merg la un callback sau revin inline cu sync: true, iar modelele de viziune acceptă un image_url.
- Concepts: listează modelele și LoRA-urile disponibile.
- Workflows: listează fluxurile de lucru și ce suportă fiecare, cum ar fi txt2img, img2img, txt2vid și img2vid.
- Knowledge base: creează un domeniu, adaugă fapte, explorează URL-uri, apoi caută sau discută.
- Skills: transformă cereri în limbaj natural în comenzi workflow.
- Utilizatori virtuali: mapează-ți utilizatorii finali la înregistrări din contul tău. Construiește și testează cu el pe API-ul personal, apoi lansează live pe o implementare de business.
Referință completă: documentația API. Documentația spune că este încă în dezvoltare.
Cazuri tipice de utilizare
- Alimentează propria ta aplicație: folosește Graydient ca backend de redare pentru o funcție de imagine, video sau chat. Dezvoltă pe API-ul personal, apoi treci la o implementare de business când vin utilizatorii reali.
- Folosește modelele tale găzduite: redă cu LoRA-urile și checkpoint-urile instalate. Vezi găzduiește-ți propriile modele AI.
- Rularea fluxurilor de lucru în stil ComfyAPI de la distanță: apelează fluxurile mapate din propriul cod.
- Imagini de produs și catalog: mărește, editează sau schimbă stilul imaginilor dintr-un pipeline, în limita de rată a API-ului personal.
- Redare în loturi: pentru loturi mari și susținute, folosește un server GPU dedicat în locul API-ului personal.
- Chat bazat pe bază de cunoștințe: construiește un asistent de suport sau documentație pe endpointurile knowledge base și chat.
Servere GPU dedicate
Dacă plănuiești să rulezi trafic automatizat, un produs multi-utilizator, acces API revândut sau redări batch toată ziua, ai nevoie de planul Business: un server GPU dedicat, cu mașina ta proprie și fără coadă partajată. Prețurile, ce este inclus și formularul de comandă sunt la business.graydient.ai.
Prețul per redare pentru un server dedicat, video inclus, este listat la business.graydient.ai. Acest preț per redare se aplică doar planului Business. Images, Video Plus și Video Max rămân cu tarif fix fără taxe per redare.
Traficul automatizat nu este permis pe planurile personale. Images, Video Plus și Video Max sunt planuri cu tarif fix pentru un singur utilizator uman, iar cheile care trimit trafic automatizat sunt revocate.
Începutul
- Abonează-te la Video Max. Poți schimba sau anula planul oricând în portal de facturare.
- Creează un token pe pagina ta de tokenuri API.
- Citește documentația API și caută pe GitHub exemple de utilizare a API-ului Graydient.
- Configurează un endpoint webhook, apoi trimite prima cerere de redare.
- Fă mirror și miniaturi ale imaginilor rezultate înainte să le servești utilizatorilor, așa cum recomandă documentația.
Suport API este disponibil prin email la info@graydient.ai. Toată utilizarea este supusă politica de utilizare acceptabilă și termeni de utilizare.