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. Images et Video Plus n'incluent pas l'accès API. Vous pouvez passer à un autre plan, rétrograder ou annuler à tout moment dans le portail de facturation, avec facturation au prorata. Les tarifs du plan Business et de l'API sont à business.graydient.ai.
L'API personnelle est une clé pour un utilisateur humain, et le trafic automatisé n'est pas autorisé sur aucun plan personnel. Cela signifie pas de bots, scripts, planificateurs, tâches par lots, scrapers, applications multi-utilisateurs ou accès revendus. Elle est limitée en fréquence : environ un appel toutes les 10 secondes. Les clés envoyant un trafic automatisé ou excessif sont révoquées sans préavis.
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-utilisateur, trafic automatisé ou accès revendu nécessite le plan Business : un serveur GPU dédié. business.graydient.ai explique ce qui est inclus, liste les prix et le vend.
| 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 vous prévoyez d'exécuter du trafic automatisé, un produit multi-utilisateur, un accès API revendu ou des rendus par lots toute la journée, vous avez besoin du plan Business : un serveur GPU dédié, avec votre propre machine et sans file d'attente partagée. Tarifs, inclusions et formulaire de commande sont à business.graydient.ai.
Le tarif par rendu pour un serveur dédié, vidéo incluse, est listé à business.graydient.ai. Ce tarif par rendu s'applique uniquement au plan Business. Images, Video Plus et Video Max restent à tarif fixe sans frais par rendu.
Le trafic automatisé n'est pas autorisé sur les plans personnels. Images, Video Plus et Video Max sont des plans à tarif fixe pour un utilisateur humain, et les clés envoyant du trafic automatisé sont révoquées.
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.