Vai al contenuto principale
POST
/
v1
/
videos
Create a Sora video job
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'
{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

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.

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