Skip to main content
Ce guide s’adresse aux applications qui envoient déjà des requêtes Seedance au format Volcengine. Vous pouvez conserver les noms d’Action, Version=2024-01-01, content[], les corps PascalCase des ressources et l’enveloppe de réponse Volcengine. Seuls le point de terminaison et l’authentification doivent changer.

​
Ce qui change

Les requêtes contenant uniquement une signature AK/SK renvoient 401 InvalidCredential. Les clients Action peuvent utiliser POST /?Action=...&Version=2024-01-01 ; POST /api/v3?Action=...&Version=2024-01-01 reste disponible. Les clients REST utilisent /api/v3/contents/generations/tasks.

​
Format des requêtes et cycle de vie des tâches

Si votre intégration envoie déjà des requêtes Seedance de style Volc, vous pouvez utiliser le point de terminaison compatible au lieu de remodeler le body pour /v1/videos/generations. Envoyez votre clé API TokenLab avec Authorization: Bearer ..., utilisez POST /api/v3/contents/generations/tasks pour la création REST ou /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 pour les requêtes Action. La création retourne un ID cgt-...; les statuts utilisent queued, running, succeeded, failed, cancelled ou expired. Ce point de terminaison compatible accepte les éléments content[] comme text, image_url, video_url, audio_url et draft_task. Les rôles d’image comme first_frame, last_frame et reference_image sont conservés. callback_url n’est pas encore pris en charge; interrogez plutôt l’endpoint de tâche.

​
Pages de référence

​
Actions de tâche

​
Exemple Action minimal

​
Ressources et vérification des personnes

Le même point de terminaison Action prend en charge dix opérations sur les ressources et leurs groupes. Consultez Actions de ressources compatibles Volcengine pour les corps PascalCase, les filtres, la pagination, l’enveloppe de réponse et les URL valables 12 heures. Pour une personne réelle, appelez aussi Créer une session de vérification visuelle et Obtenir le résultat de la vérification visuelle avant l’import.

​
Liste de contrôle de migration

  1. Remplacez l’hôte API par https://api.tokenlab.sh.
  2. Remplacez la signature AK/SK par une clé API Bearer TokenLab.
  3. Conservez l’Action, la version et la casse du corps existants.
  4. Utilisez le même ProjectName pour les requêtes associées de ressources et de vérification.
  5. Enregistrez les identifiants de tâche, de groupe et de ressource renvoyés par TokenLab.
  6. Validez une création, un polling, une liste et une erreur avant de déplacer le trafic de production.