Limites
Les limites de débit des requêtes de la Direct API, les en-têtes qui les indiquent, et ses limites de taille et de nombre.
Débit des requêtes
| Quota | Limite | Décompté par |
|---|---|---|
| Lectures de générations | 30 par minute et par génération, 1200 par minute au total | clé d’API |
Appels d’outils gratuits (listes, catalogue, plan_media et chaque URL de média qu’un appel importe) | 1000 par heure | clé d’API |
Gestion des webhooks (/webhooks et ses chemins) | 60 par minute | clé d’API |
/usage, /me | 60 par minute | clé d’API |
Requêtes dont la clé d’API ne fonctionne pas (401) | 60 par tranche de 10 minutes ; au-delà, les requêtes provenant de cette adresse reçoivent 429 (avec Retry-After) jusqu’à la fin de la fenêtre, sauf avec une clé qui s’est authentifiée au cours des 10 dernières minutes | adresse IP du client (une adresse IPv6 par son /64) |
| Appels d’outils payants | aucune limite de débit |
- Les appels payants sont limités par l’argent, pas par le débit : les limites de crédits de votre clé et le solde de votre organisation.
- En cas de forte charge, une génération attend en
queuedque le modèle ait de la capacité au lieu d’être refusée. Lancer plus de travail qu’un modèle ne peut en exécuter simultanément allonge le délai des générations suivantes, sans jamais les faire échouer. - Un appel payant qui s’est finalement révélé gratuit, comme
video_remove_audiosur une vidéo sans son, est décompté du quota des appels gratuits.
Réponses de limitation de débit
Chaque point de terminaison soumis à une limite de débit renvoie ces en-têtes :
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760Une requête refusée répond 429 avec Retry-After: <seconds> et ce corps :
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}Attendez le nombre de secondes indiqué par Retry-After avant de réessayer. Une 429 ne facture jamais rien.
Limites de taille et de nombre
| Limite | Valeur |
|---|---|
| Corps de requête | 1 Mo |
variations par lancement d’image | de 1 à 4 |
| Identifiants par lecture groupée | 10 |
wait | 45 s |
metadata | 20 clés ; clé de 40 caractères au plus, valeur de 500 au plus |
Idempotency-Key | 200 caractères au plus, conservé 24 h |
| Clés d’API actives par organisation | 10 |
| Points de terminaison de webhook par organisation | 10 |
| Durée de validité des liens d’asset | sans expiration |
| Entrées propres à chaque modèle (longueur du prompt, images de référence, durées, tailles de fichier) | comme indiqué dans Modèles et dans l’input_schema de chaque outil |
Si vous rencontrez le moindre problème ou si vous avez des questions, n’hésitez pas à nous contacter. Nous serons ravis de vous aider. Écrivez-nous à support@morphic.com.
Erreurs
Tous les codes d’erreur de la Direct API, leur signification et s’il faut réessayer, y compris la marche à suivre lorsqu’un appel payant échoue avec une 5xx.
Catalogue d’outils
Découvrez les outils de la Direct API et leurs JSON Schemas, et consultez chaque outil de la v1 avec l’autorisation dont il a besoin.