Integratiehandleidingen
Fouten
Prijzen & facturatie
Officiële API
Video aanmaken
Gebruik POST /v1/videos om Sora 2-videogeneratietaken te maken vanuit tekstprompts of referentieafbeeldingen, en vraag daarna de status op via task ID voor de resultaten.
POST
/
v1
/
videos
Create a Sora 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 airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}Gebruik dit endpoint om een nieuwe Sora-renderjob te starten vanuit tekst, of vanuit tekst plus één referentieafbeelding. De API retourneert direct een video-id en wacht niet tot het renderen is voltooid.
Begin met de kleinste bruikbare job
- Gebruik
sora-2voor snellere iteratie ofsora-2-prowanneer outputkwaliteit belangrijker is dan snelheid - Houd
secondsop4voor je eerste aanvraag - Begin met
size: 1280x720, tenzij je specifiek portrait-output nodig hebt - Upload maximaal één referentieafbeelding
Volledige flow
Poll totdat de job is voltooid
Roep Video ophalen aan totdat de status
completed of failed wordt.Download of remix het resultaat
Wanneer het renderen klaar is, haal je het bestand op met Video-inhoud ophalen. Als je een gerichte variatie wilt, gebruik dan Video remixen op het voltooide resultaat.
Sora-gedrag dat nog steeds van toepassing is
OpenAI documenteert dezelfde create -> retrieve -> download-flow in de Videos API. Op CometAPI behoud je de vorm van het Sora-verzoek, maar gebruik je de CometAPI-basis-URL en -sleutel. Voltooide download-URL’s zijn tijdelijk, dus kopieer voltooide assets naar je eigen opslag als je ze lang wilt bewaren.Autorisaties
Bearer token authentication. Use your CometAPI key.
Body
multipart/form-data
Text prompt that describes the video you want to create.
Voorbeeld:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Voorbeeld:
"sora-2"
Clip duration in seconds.
Beschikbare opties:
4, 8, 12 Voorbeeld:
"4"
Output resolution formatted as width x height.
Beschikbare opties:
720x1280, 1280x720, 1024x1792, 1792x1024 Voorbeeld:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora 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 airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}