Skip to main content
POST
Gunakan endpoint ini untuk memulai job render Sora dari teks, atau dari teks ditambah satu gambar referensi. API segera mengembalikan video id dan tidak menunggu render selesai.

​
Mulai dengan job berguna terkecil

  • Gunakan sora-2 untuk iterasi yang lebih cepat atau sora-2-pro saat kualitas output lebih penting daripada kecepatan
  • Pertahankan seconds di 4 untuk permintaan pertama Anda
  • Mulai dengan size: 1280x720 kecuali Anda memang memerlukan output potret
  • Unggah maksimal satu gambar referensi

​
Durasi dan ukuran

Sora mengharuskan field size dalam bentuk WxH yang tepat. Token resolusi seperti 720p dan label rasio seperti 16:9 bukan nilai size Sora yang valid di endpoint ini.

​
Alur end-to-end

1

Buat job render

Kirim model, prompt, seconds, dan size, lalu simpan id yang dikembalikan.
2

Lakukan polling hingga job selesai

Panggil Retrieve Video sampai status menjadi completed atau failed.
3

Unduh hasilnya

Saat render selesai, ambil file dengan Retrieve Video Content.

​
Perilaku Sora yang tetap berlaku

OpenAI mendokumentasikan alur create -> retrieve -> download yang sama di Videos API. Di CometAPI Anda tetap menggunakan bentuk permintaan Sora, tetapi memakai base URL dan key CometAPI. URL unduhan hasil yang sudah selesai bersifat sementara, jadi salin aset yang sudah selesai ke penyimpanan Anda sendiri jika memerlukan retensi jangka panjang.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
prompt
string
wajib

Text prompt that describes the video you want to create.

Contoh:

"A paper airplane glides across a desk."

​
model
string
default:sora-2

Sora model ID. Choose an available model from the Models page.

Contoh:

"sora-2"

​
seconds
enum<string>
default:4

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

Opsi yang tersedia:
4,
8,
12,
16,
20
Contoh:

"4"

​
size
enum<string>
default: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.

Opsi yang tersedia:
720x1280,
1280x720,
1024x1792,
1792x1024
Contoh:

"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
wajib
​
id
string
wajib
​
model
string
wajib
​
object
string
wajib
​
progress
integer
wajib
​
seconds
string
wajib
​
size
string
wajib
​
status
string
wajib