Passer au contenu principal

​
Méthodes d’authentification

Toutes les interfaces publiques utilisent par défaut Bearer Token : 
Authorization: Bearer YOUR_API_KEY
Adresse de base : 
https://api.aiid.edu.kg
Certaines interfaces de format natif ou dédiées à des modèles ont des chemins différents, mais utilisent toujours le même mécanisme d’authentification par clé API.

​
Structure d’erreur

Lors du dépannage de requêtes ayant échoué, concentrez-vous en priorité sur :
  • Codes d’état HTTP
  • error.code
  • error.message
Structure typique : 
{
  "error": {
    "code": "invalid_request_error",
    "message": "the reason why error occurred"
  }
}

​
Codes d’état courants

HTTPSignificationRecommandation
400Paramètres de requête invalidesVérifier les champs obligatoires, le nom du modèle et les paramètres de chemin
401Échec de l’authentificationVérifiez si la clé API est valide
404Chemin ou tâche inexistantVérifier le chemin de la requête et l’ID de la tâche
429Limite de débit atteinteRéduire la fréquence ou réessayer
500Erreur interne du serveurEnregistrer la requête et réessayer ou contacter le support

​
Énumérations d’état courantes

Énumération des rôles courants :
  • system
  • user
  • assistant
États courants des tâches longues :
  • queued
  • running
  • succeeded
  • failed
  • in_progress
  • completed
Les champs d’état renvoyés par les différentes interfaces vidéo peuvent varier légèrement, mais la sémantique tourne autour de « En attente / En cours / Terminé / Échec ».

​
Requête de tâche asynchrone

La documentation publique actuelle se concentre principalement sur la « requête active des résultats de tâche », les méthodes courantes incluent :
  • GET /v1/videos/{task_id}
  • GET /v1/responses/{response_id}
  • GET /api/v3/contents/generations/tasks/{task_id}
  • GET /suno/fetch/{task_id}
  • GET /ent/v2/tasks/{task_id}/creations
  • GET /v1beta/{operation_name}
Suggestions d’intégration :
  • Implémenter des mécanismes de retry et d’exponential backoff pour les requêtes de tâches
  • Persister task_id ou operation_name
  • La consultation des résultats sert de mécanisme de secours pour le suivi des tâches asynchrones