Naar hoofdinhoud gaan
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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-2 voor snellere iteratie of sora-2-pro wanneer outputkwaliteit belangrijker is dan snelheid
  • Houd seconds op 4 voor je eerste aanvraag
  • Begin met size: 1280x720, tenzij je specifiek portrait-output nodig hebt
  • Upload maximaal één referentieafbeelding

​
Volledige flow

1

Maak de renderjob aan

Verstuur model, prompt, seconds en size, en sla de geretourneerde id op.
2

Poll totdat de job is voltooid

Roep Video ophalen aan totdat de status completed of failed wordt.
3

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

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
prompt
string
vereist

Text prompt that describes the video you want to create.

Voorbeeld:

"A paper airplane glides across a desk."

​
model
string
standaard:sora-2

Sora model ID. Choose a current model from the Models page.

Voorbeeld:

"sora-2"

​
seconds
enum<string>
standaard:4

Clip duration in seconds.

Beschikbare opties:
4,
8,
12
Voorbeeld:

"4"

​
size
enum<string>
standaard:1280x720

Output resolution formatted as width x height.

Beschikbare opties:
720x1280,
1280x720,
1024x1792,
1792x1024
Voorbeeld:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Respons

200 - application/json

Video job accepted.

​
created_at
integer
vereist
​
id
string
vereist
​
model
string
vereist
​
object
string
vereist
​
progress
integer
vereist
​
seconds
string
vereist
​
size
string
vereist
​
status
string
vereist