Passer au contenu principal
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0-fast"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast",
  "status": "SUBMITTED",
  "progress": 0,
  "created_at": 1776681149
}
Utilisez cet endpoint pour démarrer une tâche vidéo ByteDance Seedance. Tous les niveaux de modèle Seedance partagent le même format de requête ; vous choisissez le modèle en définissant le champ model. L’appel renvoie immédiatement un id de tâche et le rendu se poursuit en arrière-plan.

​
Choisir un modèle

Model idNiveauRemarques
doubao-seedance-2-02.0Sortie de la plus haute qualité dans la famille 2.0.
doubao-seedance-2-0-fast2.0Variante plus rapide de 2.0 pour les itérations rapides et les aperçus.
doubao-seedance-1-5-pro1.5 ProPrend en charge 1080p. Text-to-video uniquement.
doubao-seedance-1-0-pro1.0 ProPrend en charge 1080p et des clips plus courts à partir de 2 secondes. Text-to-video uniquement.
Consultez la page Models pour connaître la disponibilité en temps réel.

​
Plages de paramètres

ChampTypeObligatoirePar défautValeurs autorisées
promptstringoui—tout texte
modelstringoui—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegernon5dépend du modèle (voir ci-dessous)
sizestringnon16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringnon720p480p, 720p pour les modèles 2.0 ; 480p, 720p, 1080p pour 1.5 Pro et 1.0 Pro
input_referencefilenon—JPEG, PNG ou WebP. Accepté uniquement par les modèles 2.0.

​
Plage de durée par modèle

ModèlePlage de seconds
doubao-seedance-2-0, doubao-seedance-2-0-fast4 à 15
doubao-seedance-1-5-pro4 à 12
doubao-seedance-1-0-pro2 à 10
L’envoi d’une valeur en dehors de la plage du modèle renvoie HTTP 400 avec code: "InvalidParameter" et un message concernant duration.

​
Prise en charge de l’image-to-video

Seuls les modèles 2.0 acceptent un fichier input_reference. L’envoi de input_reference avec doubao-seedance-1-5-pro ou doubao-seedance-1-0-pro renvoie HTTP 400 avec un message du type the specified task_type r2v does not support model seedance-1-5-pro. Utilisez ces modèles pour le text-to-video uniquement.

​
Télécharger une image de référence

Le corps de la requête est en multipart/form-data. Pour exécuter de l’image-to-video sur un modèle 2.0, joignez l’image en tant que partie input_reference dans la même requête : 
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
Remplacez /path/to/reference.jpg par le chemin absolu ou relatif vers l’image que vous souhaitez utiliser comme ancrage de première image. Les formats pris en charge sont JPEG, PNG et WebP.

​
Flux de tâche

1

Soumettre la tâche

Envoyez une requête POST avec au minimum prompt et model. Enregistrez l’id renvoyé pour l’étape suivante.
2

Interroger la tâche

Appelez Retrieve a Seedance video toutes les 10 à 20 secondes.
3

Télécharger la sortie

Lorsque status devient SUCCESS, téléchargez le fichier à l’adresse video_url et réhébergez-le si vous avez besoin d’un accès à long terme. L’URL est signée et expire après une durée limitée.

​
Réponses d’erreur

L’endpoint renvoie HTTP 400 lorsqu’un champ obligatoire est manquant, qu’une valeur est en dehors de la plage acceptée ou que input_reference est envoyé à un modèle qui ne prend pas en charge l’image-to-video. Il renvoie HTTP 401 lorsque le bearer token est manquant ou invalide. Le corps d’erreur utilise l’une des deux structures ; consultez les exemples 400 et 401 dans le playground pour voir les champs exacts.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

multipart/form-data
​
prompt
string
requis

Text prompt that describes the video. Required.

Exemple:

"A slow cinematic camera push across a coastal landscape at sunrise."

​
model
enum<string>
requis

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

Options disponibles:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
Exemple:

"doubao-seedance-2-0-fast"

​
seconds
integer
défaut:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

Plage requise: 2 <= x <= 15
Exemple:

5

​
size
enum<string>
défaut:16:9

Output aspect ratio. All Seedance models accept the same set of values.

Options disponibles:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Exemple:

"16:9"

​
resolution
enum<string>
défaut:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

Options disponibles:
480p,
720p,
1080p
Exemple:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

Réponse

Task created. Save the returned id and poll GET /v1/videos/{id}.

​
id
string
requis

Task id. Use it as the path parameter for GET /v1/videos/{id}.

​
object
string
requis

Object type, always video.

​
model
string
requis

Echo of the requested model id.

​
status
enum<string>
requis

Initial task status. A newly created task is returned as SUBMITTED.

Options disponibles:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
requis

Completion percentage. 0 at creation.

Plage requise: 0 <= x <= 100
​
created_at
integer
requis

Task creation time as a Unix timestamp in seconds.

​
task_id
string

Alias of id returned for compatibility. The value matches id.