Skip to main content

​
Méthodes d’authentification

Toutes les interfaces publiques utilisent par défaut Bearer Token :
Adresse de base :
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 :

​
Codes d’état courants

​
É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