Creare un video Sora 2

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

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

Inizia con il job utile più piccolo

Usa sora-2 per iterazioni più rapide 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

Durata e dimensione

Impostazione	Valori supportati	Punto di partenza predefinito	Comportamento ai limiti
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	Gli altri valori non fanno parte della forma della richiesta video Sora.
`size` per `sora-2`	`1280x720`, `720x1280`	`1280x720`	Usa l’orientamento orizzontale o verticale.
`size` per `sora-2-pro`	`1792x1024`, `1024x1792`, più le dimensioni standard di Sora	`1792x1024` per output Pro orizzontale	Usa le dimensioni Pro più grandi solo con un modello Pro.

Sora richiede il campo size nell’esatta forma WxH. Token di risoluzione come 720p ed etichette di rapporto come 16:9 non sono valori size validi per Sora su questo endpoint.

Flusso end-to-end

Crea il job di rendering

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

Controlla finché il job non termina

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

Scarica il risultato

Quando il rendering è completato, recupera il file con Retrieve Video Content.

Comportamento di Sora che continua ad applicarsi

OpenAI documenta lo stesso flusso create -> retrieve -> download nella Videos API. Su CometAPI mantieni la forma della richiesta Sora, ma usi la base URL e la chiave di CometAPI. Gli URL di download completati sono temporanei, quindi copia le risorse completate nel tuo storage se hai bisogno di 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 an available model from the Models page.

Esempio:

"sora-2"

seconds

enum<string>

predefinito:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Opzioni disponibili:

4,

8,

12,

16,

20

Esempio:

"4"

size

enum<string>

predefinito:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

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

string

obbligatorio

model

string

obbligatorio

object

string

obbligatorio

progress

integer

obbligatorio

seconds

string

obbligatorio

size

string

obbligatorio

status

string

obbligatorio

Scaricare contenuti video HappyHorse

Recuperare un video Sora 2

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Moderazione dei contenuti

Chiavi API

Inizia con il job utile più piccolo

Durata e dimensione

Flusso end-to-end

Comportamento di Sora che continua ad applicarsi

Autorizzazioni

Corpo

Risposta

​Inizia con il job utile più piccolo

​Durata e dimensione

​Flusso end-to-end

​Comportamento di Sora che continua ad applicarsi

Autorizzazioni

Corpo

Risposta

Inizia con il job utile più piccolo

Durata e dimensione

Flusso end-to-end

Comportamento di Sora che continua ad applicarsi