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"' \
  -F 'seconds="4"' \
  -F 'size="16:9"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Le champ size accepte des valeurs exactes WxH et des libellés prédéfinis de ratio. Les libellés prédéfinis de ratio correspondent aux valeurs WxH par défaut propres au modèle dans le tableau ci-dessous. Si vous avez besoin d’une sortie 720p ou 1080p spécifique, transmettez la valeur exacte WxH au lieu d’un simple libellé prédéfini de ratio. La prise en charge exacte de WxH reste dépendante du modèle ; utilisez donc une entrée de taille documentée pour le modèle cible lorsque la résolution rendue doit rester fixe.

​
Prise en charge des tailles par modèle

Le tableau ci-dessous suit la correspondance officielle des résolutions Seedance et regroupe les valeurs de taille publiées en un seul endroit. Pour 1080p, la colonne la plus à droite liste les valeurs documentées pour Seedance 1.5 Pro et Seedance 2.0. Seedance 2.0 Fast n’apparaît pas dans ce tableau officiel 1080p.
RésolutionRatio d’aspectValeurs en pixels pour la série Seedance 1.0Valeurs en pixels pour Seedance 1.5 Pro / Seedance 2.0 / Seedance 2.0 Fast
480p16:9864×480864×496
4:3736×544752×560
1:1640×640640×640
3:4544×736560×752
9:16480×864496×864
21:9960×416992×432
720p16:91248×7041280×720
4:31120×8321112×834
1:1960×960960×960
3:4832×1120834×1112
9:16704×1248720×1280
21:91504×6401470×630
1080p16:91920×10881920×1080
4:31664×12481664×1248
1:11440×14401440×1440
3:41248×16641248×1664
9:161088×19201080×1920
21:92176×9282206×946

​
En quoi les presets de ratio diffèrent des valeurs exactes WxH

Utilisez un preset de ratio lorsque la taille de sortie par défaut propre au modèle est acceptable. Pour la famille doubao-seedance-1-5-pro, les requêtes avec ratio seul utilisent la ligne 720p du tableau ci-dessus :
Preset de ratioTaille rendue par défaut
16:91280x720
4:31112x834
1:1960x960
3:4834x1112
9:16720x1280
21:91470x630
Utilisez une valeur exacte WxH lorsque la résolution rendue doit rester fixe. Par exemple, doubao-seedance-1-5-pro peut rendre 1920x1080 et 1080x1920 comme demandé. La prise en charge exacte de WxH reste dépendante du modèle. doubao-seedance-2-0 peut accepter 1920x1080 et tout de même rendre 1280x720.

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. 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"

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

Output size. Use either a ratio preset label such as 16:9, 4:3, 1:1, 3:4, 9:16, or 21:9, or an exact WxH value such as 1280x720. Ratio preset labels map to model-specific default render sizes. If you need a fixed 720p or 1080p output, pass the exact WxH value instead of only a ratio preset. Exact WxH support remains model-dependent, and an undocumented or unsupported raw WxH value can normalize to another size or fail.

Pattern: ^(16:9|4:3|1:1|3:4|9:16|21:9|[1-9]\d{2,3}x[1-9]\d{2,3})$
Exemples:

"16:9"

"1280x720"

"1920x1080"

"4:3"

"1112x834"

"1:1"

"960x960"

"3:4"

"834x1112"

"9:16"

"720x1280"

"1080x1920"

"21:9"

"1470x630"

​
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. Newly created tasks are returned as queued.

Options disponibles:
queued,
in_progress,
completed,
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.