Cosa creerai
Invierai un job video Sora 2, memorizzerai l’ID del video restituito, verificherai periodicamente fino al completamento del job e scaricherai il contenuto video finale.Prerequisiti
- Una chiave API CometAPI memorizzata in
COMETAPI_KEY - Python 3.10+ con
requests, oppure Node.js 18+ - Un worker lato server o una coda di job per il polling
Chiave API, URL di base, autenticazione
Crea job Sora con:Esempi di codice
Usa le schede qui sotto per esempi copiabili in cURL, Python e Node.js.Spiegazione del flusso
La generazione con Sora è asincrona. L’endpoint di creazione restituisce un video ID e uno stato iniziale. Esegui il polling diGET /v1/videos/<video_id> finché status non è completed o failed. Quando il job è completo, scarica il file con GET /v1/videos/<video_id>/content.
Usa dimensioni WxH esatte. Il riferimento API di Sora documenta le dimensioni standard orizzontali e verticali, con dimensioni Pro più grandi per i flussi di lavoro del modello Pro.
Parametri comuni
Risoluzione dei problemi / FAQ
La richiesta di creazione non riesce
La richiesta di creazione non riesce
Usa dati del modulo multipart. Le richieste di creazione Sora nel riferimento usano campi del modulo, non un body JSON.
Il download del contenuto non riesce
Il download del contenuto non riesce
Scarica il contenuto solo dopo che l’endpoint di stato segnala
completed. Archivia il file completato nel tuo sistema di storage.Una dimensione Pro non funziona
Una dimensione Pro non funziona
Usa dimensioni Pro più grandi solo con un flusso di lavoro di modello Pro. Inizia con
1280x720 per una prima richiesta.Passaggi successivi
- Leggi il riferimento API per creare un video Sora 2.
- Esegui il polling con Recuperare un video Sora 2.
- Scarica con Recuperare il contenuto di un video Sora 2.
- Trova i modelli video disponibili in Models.
- Consulta Usare polling e webhook per la generazione video.
- Stima il costo dell’attività con Stimare il costo della richiesta prima di chiamare un modello.