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. Images und Video Plus beinhalten keinen API-Zugang. Du kannst jederzeit im Abrechnungsportal upgraden, downgraden oder kündigen, mit anteiligen Gebühren. Preise für Business-Plan und API findest du bei business.graydient.ai.
Die persönliche API ist ein Schlüssel für einen einzelnen menschlichen Nutzer, automatisierter Traffic ist bei keinem persönlichen Plan erlaubt. Das bedeutet keine Bots, Skripte, Scheduler, Batch-Jobs, Scraper, Multi-User-Apps oder weiterverkauften Zugang. Die Nutzung ist rate-begrenzt: etwa ein Aufruf alle 10 Sekunden. Schlüssel, die automatisierten oder übermäßigen Traffic senden, werden ohne Vorwarnung gesperrt.
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 Live-Betrieb mit Multi-User-Produkt, automatisiertem Traffic oder weiterverkauften Zugang ist der Business-Plan nötig: ein dedizierter GPU-Server. business.graydient.ai erklärt, was enthalten ist, listet Preise und verkauft ihn.
| 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 automatisierten Traffic, ein Multi-User-Produkt, weiterverkauften API-Zugang oder ganztägiges Batch-Rendering planst, brauchst du den Business-Plan: einen dedizierten GPU-Server mit eigener Maschine und keiner geteilten Warteschlange. Preise, enthaltene Leistungen und Bestellformular findest du bei business.graydient.ai.
Preise pro Render für dedizierte Server, Video inklusive, findest du bei business.graydient.ai. Dieser Preis gilt nur für den Business-Plan. Images, Video Plus und Video Max bleiben Flatrate ohne pro-Render-Gebühren.
Automatisierter Traffic ist bei den persönlichen Plänen nicht erlaubt. Images, Video Plus und Video Max sind Flatrate-Pläne für einen einzelnen menschlichen Nutzer, und Schlüssel, die automatisierten Traffic senden, werden gesperrt.
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.