Crea un video Omni da testo, immagine o video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Usa questo endpoint beta per creare un task da testo a video, da immagine a video o da video a video. L’API restituisce immediatamente un ID task, quindi memorizza il valore restituito id ed esegui il polling del task finché non raggiunge uno stato terminale. Scegli il tipo di contenuto della richiesta corrispondente alla modalità di input. Invia i controlli da testo a video e da immagine a video come campi multipart/form-data. Invia una modifica di video di riferimento come corpo application/json.

Scegli una modalità di input

Obiettivo	Tipo di contenuto	Campi obbligatori	Campi facoltativi
Da testo a video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Da immagine a video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Da video a video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Gli esempi da testo a video e da immagine a video usano model=omni-fast. Gli esempi da video a video usano model=omni-fast-v2v. Consulta l’ elenco dei modelli disponibili per confermare che un ID modello sia visibile alla tua chiave API.

Anima un’immagine di riferimento

Per la generazione da immagine a video, usa model=omni-fast e carica un file PNG nel campo multipart input_reference. Il campo rimane facoltativo per la generazione da testo a video, ma è obbligatorio quando un’immagine di riferimento deve guidare il video generato. Concentra prompt sul movimento da aggiungere e indica esplicitamente i colori, le forme, i soggetti o la composizione che il risultato deve preservare. Il selettore degli esempi di codice include esempi Shell, Python e JavaScript che caricano reference.png dalla directory di lavoro e creano il task. Questa struttura della richiesta copre un file PNG caricato. Non definisce input tramite URL, altri formati di immagine, più immagini di riferimento o limiti di dimensione dei file.

Modifica un video di riferimento

Per la generazione da video a video, codifica un file MP4 locale in base64 e anteponi ai byte codificati data:video/mp4;base64,. Invia l’URL dati completo nel campo video. Descrivi le modifiche richieste in prompt. Indica inoltre i soggetti, gli oggetti, la composizione o il movimento che il risultato deve preservare. Il selettore degli esempi di codice include esempi Shell, Python e JavaScript che leggono reference.mp4 dalla directory di lavoro. Questa struttura della richiesta copre un URL dati MP4 inline. Non definisce input tramite URL, altri formati contenitore video o limiti di dimensione dei file.

Impostare durata, proporzioni e risoluzione

Omni è contrassegnato come beta perché la stabilità della generazione può variare in base all’input e alla route selezionata. Mantenere piccola la prima richiesta, quindi ispezionare il video completato prima di fare affidamento su una durata di rendering o una dimensione del frame specifiche.

Impostazione	Valori supportati	Predefinito	Comportamento ai limiti
`seconds`	Iniziare con `4`	Dipende dalla route	Considerare questa una durata richiesta e verificare l’MP4 completato, poiché la durata dell’output può differire.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` può eseguire il rendering dell’output in formato verticale. `1:1` può essere accettato durante il rendering in formato orizzontale.
`resolution`	Iniziare con `720p`; `1080p` può essere accettato	`720p`	L’attuale output di produzione può essere normalizzato a `720p` anche quando viene richiesto `1080p`.

Richiesta	Frame completato osservato
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Poiché questo endpoint è beta, considerare aspect_ratio e resolution come preferenze di generazione e verificare l’MP4 scaricato prima di fare affidamento sui pixel finali.

Flusso dell’attività

Creare l'attività

Inviare la richiesta con il tipo di contenuto per la modalità di input selezionata e archiviare il valore id restituito.

Eseguire il polling dell'attività

Chiamare Recuperare un video Omni finché status non è completed o failed.

Scaricare il risultato

Quando l’attività è completed, chiamare Recuperare il contenuto video Omni per scaricare il file MP4.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

model

string

obbligatorio

Omni model ID for this endpoint. Use omni-fast for text-to-video and image-to-video.

Esempio:

"omni-fast"

prompt

string

obbligatorio

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Esempio:

"Ocean waves rolling onto a sandy beach at golden hour"

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Esempio:

"4"

aspect_ratio

enum<string>

predefinito:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Opzioni disponibili:

16:9,

9:16,

1:1

Esempio:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Esempio:

"720p"

Risposta

200 - application/json

Task accepted. 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:

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

Show child attributes

Ultima modifica il 4 agosto 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderazione dei contenuti

Chiavi API

Crea un video Omni da testo, immagine o video

Scegli una modalità di input

Anima un’immagine di riferimento

Modifica un video di riferimento

Impostare durata, proporzioni e risoluzione

Flusso dell’attività

Autorizzazioni

Corpo

Risposta

​Scegli una modalità di input

​Anima un’immagine di riferimento

​Modifica un video di riferimento

​Impostare durata, proporzioni e risoluzione

​Flusso dell’attività

Autorizzazioni

Corpo

Risposta

Scegli una modalità di input

Anima un’immagine di riferimento

Modifica un video di riferimento

Impostare durata, proporzioni e risoluzione

Flusso dell’attività