Riferimento API
Guide all'integrazione
Prezzi e fatturazione
Wrapper CometAPI
Generazione video asincrona
Genera video Veo3 in modo asincrono tramite POST /v1/videos in CometAPI, restituendo un task id e supportando la guida del primo/ultimo frame per clip di 8 secondi.
POST
/
v1
/
videos
Create a Veo 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 kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}Usa questa pagina per avviare un job Veo tramite la route condivisa
/v1/videos di CometAPI. Scegli un alias Veo attuale dalla pagina Models quando imposti model.
Scegli il pattern della richiesta
- Text-to-video: non inviare file
input_reference - Image-to-video: invia un solo
input_reference - Guida del primo frame e dell’ultimo frame: invia due file
input_referenceordinati
Flusso del task
Invia il job Veo
Invia un alias Veo, un prompt e input immagine facoltativi, quindi salva l’
id restituito.Interroga l'endpoint video condiviso
Usa Veo3 Retrieve per seguire il task asincrono finché non raggiunge uno stato terminale.
Risoluzione degli alias
Google documenta Veo tramite le operazioni video a lunga durata di Gemini e usa nomi di modello comeveo-3.1-generate-preview. CometAPI mantiene la route condivisa /v1/videos e risolve un alias Veo attuale dalla pagina Models al momento della richiesta. Durante la validazione dal vivo del 2026-03-12, una richiesta con veo3-fast è stata accettata e ha restituito un task id asincrono, e il model della risposta è stato risolto in un id di modello del provider invece di ripetere l’alias inviato.Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
multipart/form-data
Text prompt for the video job.
Esempio:
"A paper kite floats above a field."
CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.
Esempio:
"veo3-fast"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
Esempio:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
Risposta
200 - application/json
Task accepted.
⌘I
Create a Veo 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 kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}