L’API de rendu AI Graydient
Si tu développes une appli, un outil interne ou un pipeline de rendu, Graydient te donne des modèles ouverts d’image, vidéo et LLM sur des GPU dédiés, via une seule API, à un prix mensuel fixe.
Quel forfait l’inclut
L’API personnelle est incluse uniquement avec Video Max : $84 par mois en facturation annuelle ($999 facturé annuellement) ou $99.99 mensuel. Images et Video Plus n’incluent pas l’accès API. Tu peux upgrader, downgrader ou annuler à tout moment dans le portail de facturation, avec facturation au prorata.
L’API personnelle est une clé pour un utilisateur, non revendable. Elle est limitée en débit : environ un appel toutes les 10 secondes et évite le batching. Les clés peuvent expirer automatiquement si trop de requêtes sont envoyées.
Créer un produit multi-utilisateurs ou en marque blanche
Utilisateurs virtuels et connexion en marque blanche sont des fonctionnalités business pour applis déployées, c’est-à-dire avec beaucoup d’utilisateurs. Elles fonctionnent sur l’API personnelle, tu peux donc construire et tester des flux multi-utilisateurs et marque blanche sur Video Max pendant le développement.
Passer en production avec un produit multi-utilisateurs, ou revendre l’accès, nécessite l’option business : un serveur GPU dédié ou un accord commercial. Pour discuter d’un déploiement business, écris à info@graydient.ai.
| API personnelle (Video Max) | Déploiement business | |
|---|---|---|
| Utilisateurs | Un utilisateur (toi) | Les utilisateurs de ton produit |
| Revente | Interdite | Autorisé |
| Utilisateurs virtuels et connexion en marque blanche | Construire et tester | Passer en production |
| Comment l’obtenir | S’abonner à Video Max | Serveur GPU dédié ou accord commercial |
Comment fonctionne l’API
La version actuelle est la V3, à https://cloud.graydient.ai/api/v3/. Elle suit la spécification JSON:API : envoie et accepte application/vnd.api+json, authentification avec un token HTTP Bearer standard depuis ta page de tokens API, et lecture des résultats dans un objet data avec un membre attributes.
Le rendu est asynchrone. Tu envoies un POST à POST /api/v3/render/ avec un prompt et une callback_url obligatoire. Graydient répond immédiatement avec un render_hash plus les temps d’attente et de rendu estimés. Quand le job est fini, il POST les résultats à ton webhook. Les champs optionnels incluent :
- error_url : un webhook pour les erreurs
- init_image et mask_image : pour image-à-image et inpainting
- placeholders : URLs d’images nommées pour les modes ControlNet ou adaptateurs IP
- progressive_return : un callback par image
- session_id : pour relier les rendus à tes propres utilisateurs
Les workflows passent par le même endpoint avec une commande workflow dans le prompt.
Statut sans polling : GET GET /api/v3/render/{render_hash} renvoie le statut d’un rendu, mais la doc déconseille de le poller. Utilise le webhook, ou le flux WebSocket à wss://cloud.graydient.ai/render-events/{render_hash}, qui envoie les événements started, image_done, done et error.
Autres familles d’endpoints
- Chat : chat LLM avec une persona. Les réponses vont à un callback ou reviennent en ligne avec sync: true, et les modèles vision acceptent une image_url.
- Concepts : liste les modèles et LoRAs disponibles.
- Workflows : liste les workflows et ce que chacun supporte, comme txt2img, img2img, txt2vid et img2vid.
- Base de connaissances : crée un domaine, ajoute des faits, explore des URLs, puis cherche ou discute.
- Compétences : transforme des requêtes en langage naturel en commandes workflow.
- Utilisateurs virtuels : associe tes utilisateurs finaux à des enregistrements sur ton compte. Construis et teste avec l’API personnelle, puis passe en production sur un déploiement business.
Référence complète : documentation API. La doc indique qu’ils sont encore en développement.
Cas d’usage typiques
- Alimenter ta propre app : utilise Graydient comme backend de rendu pour une fonction image, vidéo ou chat. Développe sur l’API personnelle, puis passe au déploiement business quand les vrais utilisateurs arrivent.
- Utiliser tes modèles hébergés : rends avec les LoRAs et checkpoints que tu as installés. Voir hébergez vos propres modèles IA.
- Exécution à distance de workflows de type ComfyAPI : appeler des workflows mappés depuis votre propre code.
- Images produit et catalogue : upscale, édite ou re-stylise des images via un pipeline, dans la limite de débit de l’API personnelle.
- Rendu par lots : pour des lots soutenus et volumineux, utilise un serveur GPU dédié plutôt que l’API personnelle.
- Chat base de connaissances : crée un assistant support ou documentation sur les endpoints base de connaissances et chat.
Serveurs GPU dédiés
Si tu prévois de lancer un produit multi-utilisateurs, revendre l’accès API ou faire des rendus par lots toute la journée, Graydient propose un serveur GPU Video Max dédié à $499.99 par mois. Tu as ta propre machine sans file d’attente, tu peux lancer des jobs plus longs et fixer des limites sur ce que tes clients peuvent faire et la durée de leurs créneaux. Tu peux empiler plusieurs serveurs en grandissant, et le contrat demande un préavis de 30 jours, sans engagement long terme.
Tarification des rendus sur serveurs dédiés : les rendus sur serveur dédié coûtent $0.02 chacun, vidéo incluse. Ce prix par rendu s’applique uniquement au serveur dédié. Les plans Images, Video Plus et Video Max restent au forfait, sans frais par rendu.
Pour en louer un, écris à info@graydient.ai.
Commencer
- Abonne-toi à Video Max. Tu peux changer ou annuler ton plan à tout moment dans le portail de facturation.
- Crée un token sur ta page de tokens API.
- Lis le documentation API et regarde sur GitHub des exemples d’utilisation de l’API Graydient.
- Configure un endpoint webhook, puis envoie ta première requête de rendu.
- Mets en miroir et crée des miniatures des images résultats avant de les servir à tes utilisateurs, comme recommandé dans la doc.
Le support API est disponible par email à info@graydient.ai. Toute utilisation est soumise au politique d'utilisation acceptable et aux conditions d'utilisation.