Hopp til hovedinnhold
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"
}
Bruk dette endepunktet til å starte en ny Sora-renderingsjobb fra tekst, eller fra tekst pluss ett referansebilde. API-et returnerer en video-id umiddelbart og venter ikke på at renderingen skal bli ferdig.

Start med den minste nyttige jobben

  • Bruk sora-2 for raskere iterasjon eller sora-2-pro når utskriftskvalitet er viktigere enn hastighet
  • Hold seconds4 i din første forespørsel
  • Start med size: 1280x720 med mindre du spesifikt trenger stående format
  • Last opp maksimalt ett referansebilde

Flyt fra ende til ende

1

Opprett renderingsjobben

Send model, prompt, seconds, og size, og lagre deretter den returnerte id.
2

Poll til jobben er ferdig

Kall Retrieve Video til statusen blir completed eller failed.
3

Last ned eller remix resultatet

Når renderingen er ferdig, henter du filen med Retrieve Video Content. Hvis du vil ha en målrettet variant, bruker du Remix Video på det fullførte resultatet.

Sora-atferd som fortsatt gjelder

OpenAI dokumenterer den samme create -> retrieve -> download-flyten i Videos API. På CometAPI beholder du Sora-forespørselsformatet, men bruker CometAPI-base-URL-en og nøkkelen. Ferdige nedlastings-URL-er er midlertidige, så kopier fullførte ressurser til din egen lagring hvis du trenger lang oppbevaring.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

multipart/form-data
prompt
string
påkrevd

Text prompt that describes the video you want to create.

Eksempel:

"A paper airplane glides across a desk."

model
string
standard:sora-2

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

Eksempel:

"sora-2"

seconds
enum<string>
standard:4

Clip duration in seconds.

Tilgjengelige alternativer:
4,
8,
12
Eksempel:

"4"

size
enum<string>
standard:1280x720

Output resolution formatted as width x height.

Tilgjengelige alternativer:
720x1280,
1280x720,
1024x1792,
1792x1024
Eksempel:

"1280x720"

input_reference
file

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

Svar

200 - application/json

Video job accepted.

created_at
integer
påkrevd
id
string
påkrevd
model
string
påkrevd
object
string
påkrevd
progress
integer
påkrevd
seconds
string
påkrevd
size
string
påkrevd
status
string
påkrevd