Langsung ke konten utama
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.

Gunakan endpoint ini untuk memulai job render Sora baru dari teks, atau dari teks ditambah satu gambar referensi. API segera mengembalikan video id dan tidak menunggu hingga render selesai.

​
Mulai dengan job berguna yang paling kecil

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

​
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 hingga status menjadi completed atau failed.
3

Unduh atau remix hasilnya

Ketika render selesai, ambil file dengan Retrieve Video Content. Jika Anda menginginkan variasi yang ditargetkan, gunakan Remix Video pada hasil yang sudah selesai.

​
Perilaku Sora yang masih 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 yang sudah selesai bersifat sementara, jadi salin aset yang telah selesai ke penyimpanan Anda sendiri jika Anda 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 a current model from the Models page.

Contoh:

"sora-2"

​
seconds
enum<string>
default:4

Clip duration in seconds.

Opsi yang tersedia:
4,
8,
12
Contoh:

"4"

​
size
enum<string>
default:1280x720

Output resolution formatted as width x height.

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