Crea un video Veo 3

Crea un video Veo 3.1 dal testo o da un’immagine. L’API restituisce immediatamente un ID attività. Memorizza il valore id restituito per interrogare l’attività e scaricare il video completato. POST /v1/videos utilizza multipart/form-data. Invia i controlli come campi del modulo e un’immagine come campo file input_reference.

Scegli un modello

ID modello	Quando utilizzarlo	Note
`veo3.1-fast`	Scelta predefinita per la maggior parte dei clip brevi	Percorso Veo 3.1 più rapido.
`veo3.1`	Utilizzalo se desideri specificamente il modello Veo 3.1 standard	Percorso Veo 3.1 standard.

Scegli una modalità di input

Obiettivo	Campi obbligatori	Campi facoltativi
Da testo a video	`model`, `prompt`	`seconds`, `size`
Da immagine a video	`model`, `prompt`, un file immagine `input_reference`	`seconds`, `size`

Per animare un’immagine, carica un file tramite input_reference, utilizzando il campo una sola volta. L’immagine definisce il fotogramma iniziale; prompt descrive il movimento e il comportamento della videocamera successivi.

Imposta durata e dimensioni

Per questo percorso compatibile con OpenAI, imposta la durata con un valore intero esplicito seconds e le dimensioni dell’output con size. Invia entrambi i valori come campi del modulo.

ID modello	`seconds`	Predefinito
`veo3.1-fast`	`4`, `6`, `8`	`4` secondi, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` secondi, `1280x720`

Imposta size su uno dei valori WxH seguenti.

Livello di risoluzione	Proporzioni	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Flusso dell’attività

Crea l'attività

Invia la richiesta del modulo multipart e memorizza il valore id restituito.

Interroga l'attività

Usa Veo3 Retrieve finché status non è completed, failed o error.

Scarica il risultato

Quando l’attività è completed, scarica il file MP4 dalla risposta dell’attività completata.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

enum<string>

obbligatorio

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Opzioni disponibili:

veo3.1-fast,

veo3.1

Esempio:

"veo3.1-fast"

prompt

string

obbligatorio

Text prompt for the video job.

Esempio:

"A paper kite floats above a field."

seconds

enum<integer>

predefinito:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

Opzioni disponibili:

4,

6,

8

Esempio:

4

size

string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Esempio:

"1280x720"

input_reference

file

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

Risposta

Task created. Store the returned id and poll GET /v1/videos/{task_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:

"veo3.1-fast"

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.

Moderazione dei contenuti

Chiavi API

Scegli un modello

Scegli una modalità di input

Imposta durata e dimensioni

Flusso dell’attività

Autorizzazioni

Corpo

Risposta

​Scegli un modello

​Scegli una modalità di input

​Imposta durata e dimensioni

​Flusso dell’attività

Autorizzazioni

Corpo

Risposta

Scegli un modello

Scegli una modalità di input

Imposta durata e dimensioni

Flusso dell’attività