Creare un video

Usa POST /v1/videos per creare task di generazione video Sora 2 da prompt testuali o immagini di riferimento, quindi controlla lo stato tramite l’ID del task per ottenere i risultati.

POST /v1/videos

Create a Sora video job

cURL

curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper airplane glides across a desk.' \
  --form input_reference='@example-file'

200

{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

Usa questo endpoint per avviare un nuovo job di rendering Sora da testo, oppure da testo più un’immagine di riferimento. L’API restituisce immediatamente un ID video e non attende il completamento del rendering.

​

Inizia con il job utile più piccolo

• Usa sora-2 per iterare più rapidamente oppure sora-2-pro quando la qualità dell’output conta più della velocità
• Mantieni seconds a 4 per la tua prima richiesta
• Inizia con size: 1280x720 a meno che tu non abbia bisogno specificamente di un output verticale
• Carica al massimo un’immagine di riferimento

​

Flusso end-to-end

1. Crea il job di rendering

   Invia model, prompt, seconds e size, quindi salva l’id restituito.

2. Controlla finché il job non termina

   Chiama Retrieve Video finché lo stato non diventa completed o failed.

3. Scarica o remixa il risultato

   Quando il rendering è completato, recupera il file con Retrieve Video Content. Se vuoi una variazione mirata, usa Remix Video sul risultato completato.

​

Comportamento di Sora ancora valido

OpenAI documenta lo stesso flusso create -> retrieve -> download nella Videos API. Su CometAPI mantieni la stessa struttura della richiesta Sora, ma usi l’URL di base e la chiave di CometAPI. Gli URL di download finali sono temporanei, quindi copia gli asset completati nel tuo sistema di storage se ti serve una conservazione a lungo termine.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data

prompt · string · obbligatorio

Text prompt that describes the video you want to create.

Esempio:

"A paper airplane glides across a desk."

model · string · predefinito: sora-2

Sora model ID. Choose a current model from the Models page.

Esempio:

"sora-2"

seconds · enum<string> · predefinito: 4

Clip duration in seconds.

Opzioni disponibili: 4, 8, 12

Esempio:

"4"

size · enum<string> · predefinito: 1280x720

Output resolution formatted as width x height.

Opzioni disponibili: 720x1280, 1280x720, 1024x1792, 1792x1024

Esempio:

"1280x720"

input_reference · file

Optional reference image uploaded as a file. The image should match the target size you request.

Risposta

200 - application/json

Video job accepted.

created_at · integer · obbligatorio

id · string · obbligatorio

model · string · obbligatorio

object · string · obbligatorio

progress · integer · obbligatorio

seconds · string · obbligatorio

size · string · obbligatorio

status · string · obbligatorio