Ang Graydient AI rendering API
Kung gumagawa ka ng app, internal tool o render pipeline, nagbibigay ang Graydient ng open image, video at LLM models sa dedikadong GPUs, sa likod ng isang API, sa flat buwanang presyo.
Aling plano ang kasama ito
Ang personal API ay kasama lamang sa Video Max. Ang Images at Video Plus ay walang access sa API. Maaari kang mag-upgrade, mag-downgrade o mag-cancel anumang oras sa billing portal, na may prorated na singil. Ang presyo ng Business plan at API ay nasa business.graydient.ai.
Ang personal API ay isang key para sa isang tao lang, at hindi pinapayagan ang automated traffic sa anumang personal na plano. Ibig sabihin nito ay walang bots, scripts, schedulers, batch jobs, scrapers, multi-user apps o muling pagbebenta ng access. May rate limit ito: mga isang tawag bawat 10 segundo. Ang mga key na nagpapadala ng automated o labis na traffic ay tinatanggal nang walang abiso.
Paggawa ng multi-user o white-label na produkto
Ang virtual users at white-label login ay mga business-level na feature para sa deployed apps, ibig sabihin mga produkto na maraming user. Gumagana ito sa personal API, kaya maaari kang gumawa at mag-test ng multi-user at white-label flows sa Video Max habang nagde-develop.
Ang paggamit ng live na multi-user na produkto, automated traffic o muling pagbebenta ng access ay nangangailangan ng Business plan: isang dedikadong GPU server. Ang business.graydient.ai ay nagpapaliwanag kung ano ang kasama, naglilista ng mga presyo at nagbebenta nito.
| Personal API (Video Max) | Business deployment | |
|---|---|---|
| Mga User | Isang user (ikaw) | Mga user ng iyong produkto |
| Pagbebenta muli | Hindi pinapayagan | Pinapayagan |
| Virtual na mga user at white-label login | Bumuo at subukan | Magsimulang gamitin |
| Paano makuha ito | Mag-subscribe sa Video Max | Nakatuong GPU server o kasunduan sa negosyo |
Paano gumagana ang API
Ang kasalukuyang bersyon ay V3, sa https://cloud.graydient.ai/api/v3/. Sinusunod nito ang JSON:API specification: magpadala at tumanggap ng application/vnd.api+json, mag-authenticate gamit ang standard HTTP Bearer token mula sa iyong API tokens page, at basahin ang mga resulta mula sa isang data object na may attributes member.
Asynchronous ang rendering. Mag-POST sa POST /api/v3/render/ gamit ang prompt at kinakailangang callback_url. Agad na sasagot ang Graydient ng render_hash kasama ang tinatayang oras ng paghihintay at rendering. Kapag natapos ang trabaho, ipapadala nito ang mga resulta sa iyong webhook. Kasama sa mga opsyonal na field ang:
- error_url: isang webhook para sa mga pagkabigo
- init_image at mask_image: para sa image-to-image at inpainting
- placeholders: mga pinangalanang image URL para sa ControlNet modes o IP adapters
- progressive_return: isang callback bawat imahe
- session_id: iugnay ang mga render sa iyong sariling mga user
Ang mga workflow ay tumatakbo sa parehong endpoint gamit ang workflow command sa prompt.
Status nang walang polling: GET GET /api/v3/render/{render_hash} ay nagbabalik ng status ng render, ngunit hinihiling ng docs na huwag itong i-poll. Gamitin ang webhook, o ang WebSocket stream sa wss://cloud.graydient.ai/render-events/{render_hash}, na nagpapadala ng mga event na started, image_done, done at error.
Iba pang mga pamilya ng endpoint
- Chat: LLM chat na may persona. Ang mga sagot ay pupunta sa callback o babalik nang inline gamit ang sync: true, at tinatanggap ng vision models ang image_url.
- Concepts: ilista ang mga available na modelo at LoRA.
- Workflows: ilista ang mga workflow at kung ano ang sinusuportahan ng bawat isa, tulad ng txt2img, img2img, txt2vid at img2vid.
- Knowledge base: gumawa ng domain, magdagdag ng mga katotohanan, i-crawl ang mga URL, pagkatapos ay maghanap o mag-chat.
- Skills: gawing workflow commands ang mga natural-language na kahilingan.
- Virtual users: i-map ang iyong mga end user sa mga record sa iyong account. Bumuo at subukan ito sa personal API, pagkatapos ay magsimulang gamitin sa business deployment.
Buong sanggunian: API dokumentasyon. Sinasabi ng docs na patuloy pa rin silang nagde-develop.
Karaniwang mga kaso ng paggamit
- Pagpapatakbo ng sarili mong app: gamitin ang Graydient bilang render backend para sa isang image, video o chat feature. Mag-develop sa personal API, pagkatapos lumipat sa business deployment kapag dumating na ang mga totoong user.
- Paggamit ng iyong mga naka-host na modelo: mag-render gamit ang mga LoRA at checkpoint na na-install mo. Tingnan ang mag-host ng sarili mong AI models.
- Pagpapatakbo ng mga ComfyAPI-style workflows nang remote: tawagan ang mga naka-map na workflows mula sa sarili mong code.
- Product at catalog imagery: i-upscale, i-edit o i-restyle ang mga imahe mula sa pipeline, sa loob ng rate limit ng personal API.
- Batch rendering: para sa tuloy-tuloy at mataas na volume na batch, gumamit ng nakatuong GPU server sa halip na personal API.
- Knowledge-base chat: bumuo ng support o documentation assistant gamit ang knowledge base at chat endpoints.
Nakatuong GPU servers
Kung plano mong magpatakbo ng automated traffic, multi-user na produkto, muling pagbebenta ng API access o batch renders buong araw, kailangan mo ng Business plan: isang dedikadong GPU server, na may sarili mong makina at walang shared queue. Ang presyo, kung ano ang kasama at form ng order ay nasa business.graydient.ai.
Ang presyo bawat render para sa dedikadong server, kasama ang video, ay nakalista sa business.graydient.ai. Ang presyo bawat render ay para lamang sa Business plan. Ang Images, Video Plus at Video Max ay nananatiling flat-rate na walang dagdag na singil bawat render.
Hindi pinapayagan ang automated traffic sa mga personal na plano. Ang Images, Video Plus at Video Max ay flat-rate na mga plano para sa isang tao lang, at ang mga key na nagpapadala ng automated traffic ay tinatanggal.
Pagsisimula
- Mag-subscribe sa Video Max. Maaari mong baguhin o kanselahin ang iyong plano anumang oras sa billing portal.
- Gumawa ng token sa iyong API tokens page.
- Basahin ang API dokumentasyon at tingnan sa GitHub para sa mga halimbawa ng paggamit ng Graydient API.
- Mag-set up ng webhook endpoint, pagkatapos ay magpadala ng iyong unang render request.
- I-mirror at gumawa ng thumbnail ng mga resulta ng imahe bago mo ito ibigay sa iyong mga user, ayon sa rekomendasyon ng docs.
Available ang suporta sa API sa pamamagitan ng email sa info@graydient.ai. Lahat ng paggamit ay sakop ng patakaran sa katanggap-tanggap na paggamit at mga tuntunin ng paggamit.