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 zit alleen bij Video Max: $84 per maand bij jaarlijkse betaling ($999 jaarlijks gefactureerd) of $99.99 per maand. Images en Video Plus bevatten geen API-toegang. Je kunt altijd upgraden, downgraden of annuleren in het betaalportaal, met naar rato berekende kosten.
De persoonlijke API is een sleutel voor één gebruiker en is niet voor wederverkoop. Hij is rate-limited: houd ongeveer één oproep per 10 seconden aan en vermijd batching. Sleutels kunnen automatisch verlopen als er te veel verzoeken worden gestuurd.
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, of toegang doorverkopen, vereist de zakelijke optie: een dedicated GPU-server of een zakelijke overeenkomst. Om een zakelijke uitrol te bespreken, schrijf naar info@graydient.ai.
| 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 een multi-user product wilt draaien, API-toegang wilt doorverkopen of de hele dag batch renders wilt doen, biedt Graydient een dedicated Video Max GPU-server aan voor $499.99 per maand. Je krijgt je eigen machine zonder wachtrij, kunt langere taken draaien en limieten instellen voor wat je klanten kunnen doen en hoe lang hun wachtrijslots duren. Je kunt meerdere servers stapelen naarmate je groeit, en het contract vraagt 30 dagen opzegtermijn zonder lange termijn verplichting.
Renderkosten op dedicated servers: renders op een dedicated server kosten $0.02 per stuk, video inbegrepen. Deze prijs per render geldt alleen voor de dedicated server. De Images, Video Plus en Video Max plannen blijven flat-rate, zonder kosten per render.
Om er een te huren, schrijf naar info@graydient.ai.
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.