Die Graydient AI Rendering API
Wenn du eine App, ein internes Tool oder eine Render-Pipeline baust, bietet Graydient dir offene Bild-, Video- und LLM-Modelle auf dedizierten GPUs, hinter einer API, zu einem festen monatlichen Preis.
Welcher Tarif sie enthält
Die persönliche API ist nur mit Video Max verfügbar: $84 pro Monat bei Jahresabrechnung ($999 jährlich) oder $99.99 monatlich. Images und Video Plus enthalten keinen API-Zugang. Du kannst jederzeit im Abrechnungsportal upgraden, downgraden oder kündigen, mit anteiligen Abrechnungen.
Die persönliche API ist ein Schlüssel für einen Nutzer und nicht zum Weiterverkauf gedacht. Sie ist rate-begrenzt: etwa ein Aufruf alle 10 Sekunden und kein Batching. Schlüssel können automatisch ablaufen, wenn zu viele Anfragen gesendet werden.
Ein Multi-User- oder White-Label-Produkt bauen
Virtuelle Nutzer und White-Label-Login sind Business-Features für eingesetzte Apps mit vielen Nutzern. Sie funktionieren mit der persönlichen API, sodass du Multi-User- und White-Label-Flows auf Video Max während der Entwicklung bauen und testen kannst.
Für den Live-Betrieb eines Multi-User-Produkts oder den Weiterverkauf brauchst du die Business-Option: einen dedizierten GPU-Server oder eine Geschäftsvereinbarung. Für eine Business-Deployment-Anfrage schreibe an info@graydient.ai.
| Persönliche API (Video Max) | Business-Deployment | |
|---|---|---|
| Nutzer | Ein Nutzer (du) | Die Nutzer deines Produkts |
| Weiterverkauf | Nicht erlaubt | Erlaubt |
| Virtuelle Nutzer und White-Label-Login | Erstellen und testen | Live gehen |
| Wie man es bekommt | Video Max abonnieren | Dedizierter GPU-Server oder Geschäftsvereinbarung |
Wie die API funktioniert
Die aktuelle Version ist V3, bei https://cloud.graydient.ai/api/v3/. Sie folgt der JSON:API-Spezifikation: sende und akzeptiere application/vnd.api+json, authentifiziere dich mit einem Standard-HTTP-Bearer-Token von deiner API-Token-Seite und lese Ergebnisse aus einem data-Objekt mit einem attributes-Mitglied.
Rendering ist asynchron. Du POSTest an POST /api/v3/render/ mit einem Prompt und einer erforderlichen callback_url. Graydient antwortet sofort mit einem render_hash plus geschätzten Warte- und Renderzeiten. Wenn der Job fertig ist, POSTet es die Ergebnisse an deinen Webhook. Optionale Felder sind:
- error_url: ein Webhook für Fehler
- init_image und mask_image: für Image-to-Image und Inpainting
- placeholders: benannte Bild-URLs für ControlNet-Modi oder IP-Adapter
- progressive_return: ein Callback pro Bild
- session_id: korreliere Renderings mit deinen eigenen Nutzern
Workflows laufen über denselben Endpunkt mit einem Workflow-Befehl im Prompt.
Status ohne Polling: GET GET /api/v3/render/{render_hash} gibt den Status eines Renderings zurück, aber die Dokumentation bittet dich, es nicht zu pollieren. Nutze den Webhook oder den WebSocket-Stream bei wss://cloud.graydient.ai/render-events/{render_hash}, der started, image_done, done und error Events sendet.
Andere Endpunkt-Familien
- Chat: LLM-Chat mit einer Persona. Antworten gehen an einen Callback oder kommen inline zurück mit sync: true, und Vision-Modelle akzeptieren eine image_url.
- Concepts: liste verfügbare Modelle und LoRAs auf.
- Workflows: liste Workflows und was jeder unterstützt, wie txt2img, img2img, txt2vid und img2vid.
- Knowledge base: erstelle eine Domäne, füge Fakten hinzu, crawle URLs, dann suche oder chatte.
- Skills: verwandle natürliche Sprach-Anfragen in Workflow-Befehle.
- Virtuelle Nutzer: ordne deine Endnutzer Datensätzen in deinem Account zu. Baue und teste damit auf der persönlichen API, dann gehe live mit einer Business-Deployment.
Vollständige Referenz: API-Dokumentation. Die Dokumentation sagt, sie entwickeln noch.
Typische Anwendungsfälle
- Deine eigene App betreiben: nutze Graydient als Render-Backend für ein Bild-, Video- oder Chat-Feature. Entwickle auf der persönlichen API, dann wechsle zu einem Business-Deployment, wenn echte Nutzer kommen.
- Deine gehosteten Modelle nutzen: rendere mit den LoRAs und Checkpoints, die du installiert hast. Siehe eigene KI-Modelle hosten.
- ComfyAPI-Workflows remote ausführen: auf abgebildete Workflows aus deinem eigenen Code zugreifen.
- Produkt- und Katalogbilder: skaliere hoch, bearbeite oder style Bilder aus einer Pipeline, innerhalb des Rate Limits der persönlichen API.
- Batch-Rendering: für dauerhafte, hochvolumige Batches nutze einen dedizierten GPU-Server statt der persönlichen API.
- Knowledge-Base-Chat: baue einen Support- oder Dokumentationsassistenten auf den Knowledge-Base- und Chat-Endpunkten.
Dedizierte GPU-Server
Wenn du ein Multi-User-Produkt betreiben, API-Zugänge weiterverkaufen oder den ganzen Tag Batch-Renderings machen willst, bietet Graydient einen dedizierten Video Max GPU-Server für $499.99 pro Monat an. Du bekommst deine eigene Maschine ohne Warteschlange, kannst längere Jobs laufen lassen und Limits setzen, was deine Kunden tun können und wie lange ihre Warteschlangen-Slots laufen. Du kannst mehrere Server stapeln, wenn du wächst, und der Vertrag verlangt 30 Tage Kündigungsfrist ohne langfristige Bindung.
Render-Preise auf dedizierten Servern: Renderings auf einem dedizierten Server kosten $0.02 pro Stück, Video inklusive. Dieser Preis pro Rendering gilt nur für den dedizierten Server. Die Images-, Video Plus- und Video Max-Pläne bleiben Flatrate ohne pro-Rendering-Gebühren.
Um einen zu mieten, schreibe an info@graydient.ai.
Erste Schritte
- Abonniere Video Max. Du kannst deinen Plan jederzeit im Abrechnungsportal ändern oder kündigen.
- Erstelle ein Token auf deiner API-Token-Seite.
- Lies die API-Dokumentation und schau auf GitHub nach Beispielanwendungen der Graydient API.
- Richte einen Webhook-Endpunkt ein und sende dann deine erste Render-Anfrage.
- Spiegle und erstelle Thumbnails der Ergebnisbilder, bevor du sie deinen Nutzern zeigst, wie es die Dokumentation empfiehlt.
API-Support gibt es per E-Mail unter info@graydient.ai. Alle Nutzung unterliegt den Richtlinie zur akzeptablen Nutzung und den Nutzungsbedingungen.