Maak een Sora 2-video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Gebruik deze endpoint om een 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 nuttige job

Gebruik sora-2 voor snellere iteratie of sora-2-pro wanneer uitvoerkwaliteit belangrijker is dan snelheid
Houd seconds op 4 voor je eerste request
Begin met size: 1280x720 tenzij je specifiek portretuitvoer nodig hebt
Upload maximaal één referentieafbeelding

Duur en grootte

Setting	Ondersteunde waarden	Standaard startpunt	Grensgedrag
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	Andere waarden maken geen deel uit van de Sora-video request-vorm.
`size` voor `sora-2`	`1280x720`, `720x1280`	`1280x720`	Gebruik liggende of staande oriëntatie.
`size` voor `sora-2-pro`	`1792x1024`, `1024x1792`, plus de standaard Sora-groottes	`1792x1024` voor liggende Pro-uitvoer	Gebruik de grotere Pro-groottes alleen met een Pro-model.

Sora vereist het veld size in de exacte vorm WxH. Resolutietokens zoals 720p en verhoudingslabels zoals 16:9 zijn geen geldige Sora-size-waarden op deze endpoint.

End-to-end-flow

Maak de renderjob

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

Poll totdat de job is voltooid

Roep Retrieve Video aan totdat de status completed of failed wordt.

Download het resultaat

Wanneer het renderen klaar is, haal je het bestand op met Retrieve Video Content.

Sora-gedrag dat nog steeds van toepassing is

OpenAI documenteert dezelfde create -> retrieve -> download-flow in de Videos API. Op CometAPI behoud je de Sora request-vorm, 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 langdurig 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 an available model from the Models page.

Voorbeeld:

"sora-2"

seconds

enum<string>

standaard:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Beschikbare opties:

4,

8,

12,

16,

20

Voorbeeld:

"4"

size

enum<string>

standaard:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

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

string

vereist

model

string

vereist

object

string

vereist

progress

integer

vereist

seconds

string

vereist

size

string

vereist

status

string

vereist

HappyHorse-video-inhoud downloaden

Een Sora 2-video ophalen

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Contentmoderatie

API-sleutels

Begin met de kleinste nuttige job

Duur en grootte

End-to-end-flow

Sora-gedrag dat nog steeds van toepassing is

Autorisaties

Body

Respons

​Begin met de kleinste nuttige job

​Duur en grootte

​End-to-end-flow

​Sora-gedrag dat nog steeds van toepassing is

Autorisaties

Body

Respons

Begin met de kleinste nuttige job

Duur en grootte

End-to-end-flow

Sora-gedrag dat nog steeds van toepassing is