De Graydient AI rendering API
Als je een app, intern hulpmiddel of renderpipeline bouwt, geeft Graydient je open beeld-, video- en LLM-modellen op dedicated GPU's, achter één API, tegen een vast maandtarief.
Welk plan het bevat
De persoonlijke API is alleen inbegrepen bij Video Max. Images en Video Plus bevatten geen API-toegang. Je kunt op elk moment upgraden, downgraden of annuleren in het betaalportaal, met pro rata kosten. Business plan en API prijzen staan op business.graydient.ai.
De persoonlijke API is een sleutel voor één menselijke gebruiker, en geautomatiseerd verkeer is niet toegestaan op persoonlijke plannen. Dat betekent geen bots, scripts, planners, batchtaken, scrapers, multi-user apps of doorverkochte toegang. Het is rate-limited: houd het bij ongeveer één oproep per 10 seconden. Sleutels die geautomatiseerd of excessief verkeer sturen worden zonder waarschuwing ingetrokken.
Een multi-user of white-label product bouwen
Virtuele gebruikers en white-label login zijn functies op zakelijk niveau voor uitgerolde apps, dus producten met veel gebruikers. Ze werken op de persoonlijke API, zodat je multi-user en white-label flows kunt bouwen en testen op Video Max tijdens ontwikkeling.
Live gaan met een multi-user product, geautomatiseerd verkeer of doorverkochte toegang vereist het Business plan: een dedicated GPU-server. business.graydient.ai legt uit wat inbegrepen is, toont de prijzen en verkoopt het.
| Persoonlijke API (Video Max) | Zakelijke uitrol | |
|---|---|---|
| Gebruikers | Één gebruiker (jij) | De gebruikers van jouw product |
| Doorverkoop | Niet toegestaan | Toegestaan |
| Virtuele gebruikers en white-label login | Bouwen en testen | Live gaan |
| Hoe te verkrijgen | Abonneer op Video Max | Dedicated GPU-server of zakelijke overeenkomst |
Hoe de API werkt
De huidige versie is V3, bij https://cloud.graydient.ai/api/v3/. Het volgt de JSON:API-specificatie: stuur en accepteer application/vnd.api+json, authenticatie met een standaard HTTP Bearer-token van je API-tokenspagina, en lees resultaten uit een data-object met een attributes-lid.
Rendering is asynchroon. Je POST naar POST /api/v3/render/ met een prompt en een verplichte callback_url. Graydient reageert meteen met een render_hash plus geschatte wachttijd en rendertijd. Wanneer de taak klaar is, POST het de resultaten naar je webhook. Optionele velden zijn onder andere:
- error_url: een webhook voor fouten
- init_image en mask_image: voor image-to-image en inpainting
- placeholders: benoemde afbeeldings-URL's voor ControlNet-modi of IP-adapters
- progressive_return: één callback per afbeelding
- session_id: koppel renders aan je eigen gebruikers
Workflows lopen via hetzelfde eindpunt met een workflow-commando in de prompt.
Status zonder polling: GET GET /api/v3/render/{render_hash} geeft de status van een render, maar de documentatie raadt aan dit niet te poll-en. Gebruik de webhook, of de WebSocket-stream op wss://cloud.graydient.ai/render-events/{render_hash}, die started, image_done, done en error events stuurt.
Andere eindpuntfamilies
- Chat: LLM-chat met een persona. Antwoorden gaan naar een callback of komen inline terug met sync: true, en vision-modellen accepteren een image_url.
- Concepten: lijst beschikbare modellen en LoRA's.
- Workflows: lijst workflows en wat elk ondersteunt, zoals txt2img, img2img, txt2vid en img2vid.
- Kennisbank: maak een domein aan, voeg feiten toe, crawl URL's, en zoek of chat daarnaar.
- Skills: zet natuurlijke taalverzoeken om in workflow-commando's.
- Virtuele gebruikers: koppel je eindgebruikers aan records op je account. Bouw en test ermee op de persoonlijke API, ga dan live op een zakelijke deployment.
Volledige referentie: API-documentatie. De documentatie zegt dat ze nog in ontwikkeling zijn.
Typische gebruikssituaties
- Je eigen app aandrijven: gebruik Graydient als render-backend voor een afbeelding-, video- of chatfunctie. Ontwikkel op de persoonlijke API, en ga over naar een zakelijke deployment als er echte gebruikers komen.
- Je gehoste modellen gebruiken: render met de LoRA's en checkpoints die je hebt geïnstalleerd. Zie host je eigen AI-modellen.
- ComfyAPI-stijl workflows op afstand uitvoeren: aangemaakte workflows aanroepen vanuit je eigen code.
- Product- en catalogusafbeeldingen: opschalen, bewerken of restylen van afbeeldingen uit een pipeline, binnen de rate limit van de persoonlijke API.
- Batch-rendering: voor langdurige, grote batches, gebruik een dedicated GPU-server in plaats van de persoonlijke API.
- Kennisbank-chat: bouw een support- of documentatie-assistent op de kennisbank- en chat-eindpunten.
Dedicated GPU-servers
Als je geautomatiseerd verkeer, een multi-user product, doorverkochte API-toegang of batch renders de hele dag wilt draaien, heb je het Business plan nodig: een dedicated GPU-server, met je eigen machine en geen gedeelde wachtrij. Prijzen, wat inbegrepen is en het bestelformulier staan op business.graydient.ai.
Per-render prijzen voor een dedicated server, inclusief video, staan op business.graydient.ai. Die per-render prijs geldt alleen voor het Business plan. Images, Video Plus en Video Max blijven flat-rate zonder per-render kosten.
Geautomatiseerd verkeer is niet toegestaan op persoonlijke plannen. Images, Video Plus en Video Max zijn flat-rate plannen voor één menselijke gebruiker, en sleutels die geautomatiseerd verkeer sturen worden ingetrokken.
Aan de slag
- Abonneer op Video Max. Je kunt je plan altijd wijzigen of annuleren in het betaalportaal.
- Maak een token aan op je API-tokenspagina.
- Lees de API-documentatie en kijk op GitHub voor voorbeeldgebruik van de Graydient API.
- Stel een webhook-eindpunt in en stuur je eerste renderverzoek.
- Mirror en maak thumbnail-resultaatafbeeldingen voordat je ze aan je gebruikers serveert, zoals de documentatie aanbeveelt.
API-ondersteuning is beschikbaar per e-mail op info@graydient.ai. Elk gebruik is onderhevig aan de beleid voor acceptabel gebruik en de gebruiksvoorwaarden.