Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
Wrapper CometAPI
Asynchroniczne generowanie wideo
Generuj filmy Veo3 asynchronicznie przez POST /v1/videos w CometAPI, otrzymując id zadania oraz obsługę wskazania pierwszej/ostatniej klatki dla 8-sekundowych klipów.
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"
}Użyj tej strony, aby uruchomić zadanie Veo przez współdzieloną trasę CometAPI
/v1/videos. Podczas ustawiania model wybierz aktualny alias Veo na stronie Models page.
Wybierz wzorzec żądania
- Text-to-video: nie wysyłaj żadnych plików
input_reference - Image-to-video: wyślij jedno
input_reference - First-frame and last-frame guidance: wyślij dwa uporządkowane pliki
input_reference
Przepływ zadania
Wyślij zadanie Veo
Wyślij alias Veo, prompt oraz opcjonalne obrazy wejściowe, a następnie zapisz zwrócone
id.Odpytuj współdzielony endpoint wideo
Użyj Veo3 Retrieve, aby śledzić zadanie asynchroniczne, aż osiągnie stan końcowy.
Rozwiązywanie aliasu
Google dokumentuje Veo przez długotrwałe operacje wideo Gemini i używa nazw modeli takich jakveo-3.1-generate-preview. CometAPI zachowuje współdzieloną trasę /v1/videos i w momencie żądania rozwiązuje aktualny alias Veo ze strony Models page. Podczas walidacji na żywo 2026-03-12 żądanie z veo3-fast zostało zaakceptowane i zwróciło asynchroniczne id zadania, a pole model w odpowiedzi zostało rozwiązane do id modelu dostawcy zamiast powtórzyć przesłany alias.Autoryzacje
Bearer token authentication. Use your CometAPI key.
Treść
multipart/form-data
Text prompt for the video job.
Przykład:
"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.
Przykład:
"veo3-fast"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
Przykład:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
⌘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"
}