Skip to main content
POST
cURL
Usa questo endpoint per creare un’attività Wan da testo a video. L’API restituisce immediatamente un ID attività, quindi memorizza l’id restituito e interroga l’attività finché non raggiunge uno stato terminale. POST /v1/videos usa multipart/form-data; passa i controlli scalari come campi del form.

Scegli un modello

Imposta durata e dimensione

Imposta size su uno dei valori WxH seguenti per il modello di destinazione.

Valori di size per Wan 2.7

Valori di size per Wan 2.6

Flusso dell’attività

1

Crea l'attività

Invia la richiesta del form multipart e memorizza l’id restituito.
2

Interroga l'attività

Chiama Retrieve a Wan video finché status non è completed, failed oppure error.
3

Scarica il risultato

Quando l’attività è completed, chiama Retrieve Wan video content per scaricare il file MP4.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data
model
enum<string>
obbligatorio

Wan model ID for this endpoint.

Opzioni disponibili:
wan2.6,
wan2.7
Esempio:

"wan2.6"

prompt
string
obbligatorio

Text prompt that describes the video to generate.

Esempio:

"A small robot walks through a bright greenhouse with smooth camera movement."

seconds
string

Requested clip duration in seconds. For wan2.6, use 5, 10, or 15. For wan2.7, use an integer from 2 through 15. Default is 5.

Esempio:

"5"

size
string

Supported WxH size values. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080.

Esempio:

"1280x720"

Risposta

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

id
string
obbligatorio

Task ID. Use this value with retrieve and content endpoints.

Esempio:

"task_example"

object
string
obbligatorio

Object type. Video tasks return video.

Esempio:

"video"

model
string
obbligatorio

Model ID used for the task.

Esempio:

"wan2.6"

status
enum<string>
obbligatorio

Task lifecycle status. Poll until the value is completed, failed, or error.

Opzioni disponibili:
queued,
in_progress,
completed,
failed,
error
Esempio:

"queued"

progress
integer
obbligatorio

Task progress as a coarse percentage.

Intervallo richiesto: 0 <= x <= 100
Esempio:

0

created_at
integer
obbligatorio

Task creation time as a Unix timestamp in seconds.

Esempio:

1779938152

task_id
string

Compatibility alias for id when present.

Esempio:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Esempio:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Esempio:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.