Authentification
Créez des clés d’API, envoyez-les à chaque requête et comprenez les portées et les endpoints.
Clé d’API
Créez des clés dans la console avec un nom et une expiration, y compris sans expiration. Les nouvelles clés incluent toutes les autorisations API standard et peuvent être réaffichées après connexion. Ne placez jamais de clés dans du code côté client ni dans des dépôts publics.
| Portée | Autorise |
|---|---|
jobs:create | Soumettre des tâches |
jobs:read | Interroger et lister les tâches |
media:write | Importer des images ou vidéos d’entrée |
media:read | Télécharger les fichiers de résultat |
usage:read | Lire les crédits et l’historique |
chat:create | Call chat completions |
Envoyer la clé
Envoyez la clé via Authorization: Bearer <key> ou x-api-key: <key> — pas les deux. La console web et le playground utilisent votre session connectée.
Une clé absente ou invalide renvoie 401 AUTH_REQUIRED ; une clé sans la portée requise renvoie 403 INSUFFICIENT_SCOPE.
Endpoints
| Méthode | Chemin | Rôle | Auth. |
|---|---|---|---|
GET | /api/v1/models | Liste le catalogue public des modèles | Public |
GET | /api/v1/models/{slug} | Un modèle avec son schéma d’entrée | Public |
GET | /api/v1/prices | Prix par tâche configurés (micro-unités USD) | Public |
POST | /api/v1/media | Importe des octets d’image ou de vidéo et renvoie media:<uuid> | media:write |
POST | /api/v1/jobs | Soumet une tâche de modèle asynchrone | jobs:create |
GET | /api/v1/jobs/{id} | Interroge le statut et les résultats d’une tâche | jobs:read |
GET | /api/v1/jobs | Vos 100 dernières tâches | jobs:read |
GET | /api/v1/results/{id} | Télécharge un fichier de résultat vous appartenant | media:read |
GET | /api/v1/usage | Solde de crédits et historique récent | usage:read |
GET | /api/v1/chat/models | Callable chat models with token prices (OpenAI list format) | Public |
POST | /api/v1/chat/completions | OpenAI-compatible chat completion, billed per token | chat:create |
GET | /api/v1/chat/requests | Your chat requests with charges, limit (1–100) and before cursor | usage:read |
GET | /api/v1/chat/requests/{id} | One chat request belonging to your account | usage:read |
Agents IA
Les agents IA peuvent se connecter via OAuth par le serveur MCP au lieu d’utiliser une clé. MCP et Skill