Graydient AI rendering API
Pokud vytváříte aplikaci, interní nástroj nebo render pipeline, Graydient vám poskytne otevřené obrazové, video a LLM modely na dedikovaných GPU za paušální měsíční cenu, vše za jedním API.
Který plán ho obsahuje
Osobní API je dostupné pouze s Video Max. Images a Video Plus API přístup nemají. Můžeš kdykoli upgradovat, downgradovat nebo zrušit v platební portál s poměrnou platbou. Ceny Business plánu a API jsou na business.graydient.ai.
Osobní API je klíč pro jednoho lidského uživatele a automatizovaný provoz není povolen u žádného osobního plánu. To znamená žádné boty, skripty, plánovače, dávkové úlohy, scrapers, aplikace pro více uživatelů ani prodej přístupu. Je omezen na přibližně jeden požadavek za 10 sekund. Klíče, které posílají automatizovaný nebo nadměrný provoz, jsou zrušeny bez upozornění.
Vytváření multi-uživatelského nebo white-label produktu
Virtuální uživatelé a white-label přihlášení jsou funkce na úrovni business pro nasazené aplikace s mnoha uživateli. Fungují na osobním API, takže můžete během vývoje stavět a testovat multi-uživatelské a white-label toky na Video Max.
Pro živý provoz s produktem pro více uživatelů, automatizovaný provoz nebo prodej přístupu je potřeba Business plán: dedikovaný GPU server. business.graydient.ai vysvětluje, co je zahrnuto, uvádí ceny a umožňuje nákup.
| Osobní API (Video Max) | Business nasazení | |
|---|---|---|
| Uživatelé | Jeden uživatel (ty) | Uživatelé tvého produktu |
| Přeprodej | Nepovoleno | Povoleno |
| Virtuální uživatelé a přihlášení na bílé značce | Vytvářet a testovat | Jít do ostrého provozu |
| Jak to získat | Přihlásit se k Video Max | Vyhrazený GPU server nebo obchodní dohoda |
Jak API funguje
Aktuální verze je V3, na https://cloud.graydient.ai/api/v3/. Dodržuje specifikaci JSON:API: posílej a přijímej application/vnd.api+json, autentizuj se standardním HTTP Bearer tokenem ze stránky s API tokeny a čti výsledky z objektu data s členem attributes.
Renderování je asynchronní. Pošli POST na POST /api/v3/render/ s promptem a povinným callback_url. Graydient odpoví hned render_hash plus odhadovanými časy čekání a renderování. Když úloha skončí, pošle výsledky na tvůj webhook. Nepovinná pole zahrnují:
- error_url: webhook pro chyby
- init_image a mask_image: pro image-to-image a inpainting
- placeholders: pojmenované URL obrázků pro režimy ControlNet nebo IP adaptéry
- progressive_return: jeden callback na obrázek
- session_id: pro spojení renderů s tvými uživateli
Workflows běží přes stejný endpoint s workflow příkazem v promptu.
Status bez dotazování: GET GET /api/v3/render/{render_hash} vrací stav renderu, ale dokumentace doporučuje ho nepollovat. Použij webhook nebo WebSocket stream na wss://cloud.graydient.ai/render-events/{render_hash}, který posílá události started, image_done, done a error.
Další rodiny endpointů
- Chat: LLM chat s personou. Odpovědi jdou na callback nebo inline se sync: true, a vision modely přijímají image_url.
- Concepts: vypsat dostupné modely a LoRA.
- Workflows: vypsat workflow a co podporují, jako txt2img, img2img, txt2vid a img2vid.
- Knowledge base: vytvořit doménu, přidat fakta, procházet URL, pak hledat nebo chatovat.
- Skills: převést požadavky v přirozeném jazyce na workflow příkazy.
- Virtuální uživatelé: mapuj své koncové uživatele na záznamy na svém účtu. Stavět a testovat na osobním API, pak jít do ostrého provozu na business deploymentu.
Plná reference: dokumentace API. Dokumentace říká, že se stále vyvíjí.
Typické případy použití
- Pohánění vlastní aplikace: použij Graydient jako render backend pro obrázky, video nebo chat. Vyvíjej na osobním API, pak přejdi na business deployment, až přijdou skuteční uživatelé.
- Používání vlastních hostovaných modelů: renderuj s LoRA a checkpointy, které máš nainstalované. Viz hostuj své vlastní AI modely.
- Vzdálené spouštění ComfyAPI-style workflow: volání namapovaných workflow z vlastního kódu.
- Produktové a katalogové obrázky: zvětšuj, upravuj nebo měň styl obrázků z pipeline, v rámci limitu osobního API.
- Hromadné renderování: pro trvalé, velké dávky použij vyhrazený GPU server místo osobního API.
- Chat na bázi znalostní databáze: vytvoř asistenta podpory nebo dokumentace na knowledge base a chat endpointu.
Vyhrazené GPU servery
Pokud plánuješ provozovat automatizovaný provoz, produkt pro více uživatelů, prodej API přístupu nebo dávkové renderování celý den, potřebuješ Business plán: dedikovaný GPU server s vlastním strojem a bez sdílené fronty. Ceny, co je zahrnuto a objednávkový formulář jsou na business.graydient.ai.
Cena za render na dedikovaném serveru, video v ceně, je uvedena na business.graydient.ai. Tato cena za render platí pouze pro Business plán. Images, Video Plus a Video Max mají fixní cenu bez poplatků za render.
Automatizovaný provoz není povolen u osobních plánů. Images, Video Plus a Video Max jsou fixní plány pro jednoho lidského uživatele a klíče, které posílají automatizovaný provoz, jsou zrušeny.
Začínáme
- Přihlas se k Video Max. Plán můžeš kdykoli změnit nebo zrušit v platební portál.
- Vytvoř token na stránce API tokenů.
- Přečti si dokumentace API a podívej se na GitHub pro příklady použití Graydient API.
- Nastav webhook endpoint a pošli první render request.
- Zrcadli a vytvářej miniatury výsledných obrázků před jejich podáním uživatelům, jak doporučuje dokumentace.
Podpora API je dostupná emailem na info@graydient.ai. Veškeré použití podléhá zásady přijatelných pravidel použití a podmínky použití.