curl-X POST 'https://pollo.ai/api/platform/v1/generation/openai/sora-2-pro/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "duration": 4, "aspectRatio": "16:9", "resolution": "720p" }}'
È possibile includere facoltativamente l'URL del webhook per ricevere una notifica in caso di successo o fallimento dell'attività.
Campo di richiesta facoltativo
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","duration":4,"aspectRatio":"16:9","resolution":"720p"},"webhookUrl":"https://example.com/webhooks/pollo"}
Schema
Campi di input per l'endpoint e la modalità selezionati.
Campo
Tipo
Necessario
Descrizione
prompt
string
Sì
Text prompt describing the content to generate.
duration
number
NO
The duration of the generated video, in seconds.
aspectRatio
string
NO
Output aspect ratio, as width:height (e.g. 16:9).
resolution
string
NO
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
Sora 2 Pro supporta prompt lunghi e dettagliati e genera scene con oggetti coordinati, illuminazione, movimento fisico e continuità visiva lungo tutta la clip.
Con Sora 2 Pro su Pollo API, puoi integrare la generazione da testo a video e da immagine a video, con durata della clip configurabile, inquadratura verticale o orizzontale e risoluzioni di output fino a 1080p.
Funzionalità principali dell’API di Sora 2 Pro
Simulazione del mondo
Genera scene dinamiche mantenendo il posizionamento e l’aspetto di superfici, ombre, oggetti e soggetti in movimento mentre la camera e l’azione avanzano.
Audio sincronizzato
Genera dialoghi, atmosfera ed effetti sonori sincronizzati insieme al video, allineando i segnali audio con voce, movimento ed eventi sullo schermo.
Comprensione di prompt lunghi
Supporta prompt dettagliati per definire più battute di scena, azioni dei soggetti, messa in scena, direzione della camera e atmosfera in un’unica generazione.
Durata estesa della clip
Le generazioni durano 4, 8, 12, 16 o 20 secondi, ideali per azioni, dialoghi e brevi sequenze narrative che richiedono più tempo di sviluppo.
Plausibilità fisica
Genera movimenti consapevoli di peso, quantità di moto e contatto per azioni fisiche con oggetti che cadono, liquidi, collisioni e soggetti in movimento.
Risoluzione premium
L’output arriva fino a 1080p con dettagli puliti, mantenendo texture, volti e micromovimenti abbastanza nitidi per la consegna finale e non solo per anteprime di bozza.
Casi d’uso dell’API di Sora 2 Pro
Scene guidate dal dialogo: Genera brevi momenti parlati in cui movimento delle labbra, tono e suono ambientale sono allineati, utile per app narrative e contenuti guidati da personaggi.
Sequenze esplicative: Crea walkthrough visivi multi-step da un prompt dettagliato, permettendo ad azioni e processi di svilupparsi lungo clip più lunghe.
Ambienti simulati: Produci meteo, acqua, folle e traffico con movimento coordinato e continuità di scena per flussi di lavoro di previsualizzazione e world-building.
Contenuti verticali per storytelling: Crea clip 9:16 ottimizzate per feed short-form, con audio sincronizzato pronto per piattaforme di storytelling mobile-first.
Prototipazione da prompt a scena: Genera prime interpretazioni visive di scene dettagliate per valutare messa in scena, ritmo, direzione della camera e continuità prima della produzione.
Movimento guidato da immagine: Converti un’immagine sorgente in un video con movimento e audio sincronizzato, preservandone soggetto principale, composizione e direzione visiva.
Film concettuali: Genera scene atmosferiche estese che richiedono continuità visiva, narrativa e audio prolungata.
Come usare l’API di Sora 2 Pro
Ottieni una chiave API: Crea un account Pollo API e genera la tua chiave dalla dashboard sviluppatore, poi passala nell’header x-api-key.
Scegli il modello: Invia la tua richiesta all’endpoint Sora 2 Pro su /generation/sora/sora-2-pro.
Aggiungi i tuoi input: Fornisci un prompt per testo-a-video, oppure un URL image per immagine-a-video, poi imposta length (4-20), resolution (fino a 1080p) e aspectRatio (16:9 o 9:16).
Genera e recupera: Invia il task, controlla periodicamente lo stato del task restituito oppure registra un webhook, poi scarica il video finale quando va a buon fine.
Best practice di prompting per l’API di Sora 2 Pro
Scrivi il prompt come un brief di scena anziché come una lista di parole chiave. Descrivi ambientazione, soggetti, azioni, dialoghi, suono e movimento di camera per guidare la struttura della scena e la continuità complessiva.
Una formula semplice per i prompt
Ambientazione e atmosfera + soggetto e azione specifica + dialogo o segnale sonoro + movimento di camera + ritmo adatto alla durata
Cosa dovresti notare
Imposta prima il mondo: Indica luogo, ora del giorno e atmosfera così l’ambiente resta coerente per tutta la clip.
Dai indicazioni per l’audio: Includi dialoghi parlati, suono ambientale, musica o effetti sonori per guidare l’output audio sincronizzato.
Regola il ritmo in base alla durata: Adatta numero e complessità delle azioni in base alla lunghezza della clip selezionata.
Metti in scena il movimento: Specifica come soggetti e camera si muovono insieme per mantenere la simulazione credibile e leggibile.
Mantieni esplicita la continuità: Descrivi cosa deve persistere, come l’abbigliamento di un personaggio o una fonte di luce, per mantenere coerenza negli shot più lunghi.
Esempi di prompt
Scena di mercato sotto la pioggia
"Un mercato notturno affollato sotto la pioggia, venditori che richiamano i clienti sotto file di luci, vapore che sale dalle bancarelle di cibo. Un cliente contratta, ride e consegna contanti. Carrellata lenta tra la folla, brusio ambientale e sfrigolio, 12 secondi."
Momento di dialogo in cucina
"Una nonna mescola una pentola e dice: 'Assaggia questo, dimmi se serve sale', mentre un adolescente si avvicina e sorseggia. Luce calda del pomeriggio, leggero avvicinamento di camera, tintinnio di cucchiai e voci dolci sincronizzate con i loro movimenti."
Studio fisico costiero
"Le onde arrivano su una riva rocciosa, gli spruzzi esplodono all’impatto e si ritirano con il riflusso della marea, gabbiani che attraversano il cielo. Inquadratura ampia e statica, luce naturale del mattino, suono stratificato di oceano e vento, sostenuto lungo una clip lunga."
Sessione skate verticale
"Uno skater curva lungo la rampa vuota di un parcheggio multipiano, ruote che vibrano sulle giunture del cemento, tavola che sbatte a ogni curva. Inquadratura verticale 9:16, camera che segue da vicino da dietro, acustica rimbombante del garage, ritmo veloce e sicuro."
Sora 2 Pro vs Veo 3.1 vs Kling 2.6
Capacità
Sora 2 Pro
Veo 3.1
Kling 2.6
Simulazione del mondo e coerenza
✅ Forte coerenza nelle scene lunghe
✅ Forte controllo della scena
✅ Buon movimento, minore focus sul mondo
Audio sincronizzato
✅
✅
❌ Limitato
Lunghezza massima clip
Fino a 20 secondi
Clip dirette brevi
Clip dirette brevi
Opzioni di risoluzione
720p, 1024p, 1080p
Fino a 1080p
Fino a 1080p
Modalità di input
Testo e immagine
Testo, immagine, riferimento
Testo e immagine
Consigliato per
Scene lunghe, con audio e coerenti
Inquadrature cinematografiche controllate
Movimento fluido dei personaggi
Perché scegliere l’API di Sora 2 Pro?
Sora 2 Pro è adatto ad applicazioni che richiedono scene estese, audio sincronizzato e continuità visiva. Il supporto a dialoghi, ambienti simulati e clip fino a 20 secondi lo rende adatto a storytelling, contenuti esplicativi, previsualizzazione e workflow di contenuti basati su scene.
Attraverso Pollo API, Sora 2 Pro è accessibile insieme ad altri modelli video e immagine tramite un’unica API, con supporto per polling dello stato dei task e webhook, semplificando valutazione dei modelli, integrazione e deployment.
FAQ dell’API di Sora 2 Pro
Che cos’è Sora 2 Pro?
Sora 2 Pro è il modello video premium di OpenAI che simula ambienti del mondo reale con audio sincronizzato e forte coerenza, supportando testo-a-video e immagine-a-video fino a 20 secondi.
L’API di Sora 2 Pro supporta input testuali e immagini?
Sì. Puoi generare da un prompt scritto o animare un URL immagine, rendendolo flessibile sia per workflow idea-first sia asset-first.
Quanto possono durare le clip di Sora 2 Pro?
Le clip possono durare 4, 8, 12, 16 o 20 secondi, offrendo più spazio rispetto alla maggior parte dei modelli affinché azioni e dialoghi si risolvano in un’unica generazione.
Sora 2 Pro genera audio?
Sì. Produce suono sincronizzato, allineando dialoghi e audio ambientale con il movimento sullo schermo così voce ed eventi restano a tempo con il girato.
Quali risoluzioni e inquadrature sono disponibili?
Sora 2 Pro produce output fino a 1080p in formato wide 16:9 o verticale 9:16, selezionabile per richiesta in base al formato di delivery.
Perché eseguire Sora 2 Pro tramite Pollo API?
Pollo API fornisce accesso a Sora 2 Pro insieme ad altri modelli video e immagine tramite una singola integrazione, con documentazione API, tracciamento dello stato dei task e supporto webhook per la generazione video asincrona.
