Sora 2 video oluşturma API'si
APIMaster.ai üzerinde sora-2 ve sora-2-pro'yu metin-video ve görsel-video için çağırın. Yoklama ve indirmeler APIMaster URL'lerini kullanır.
Sora 2 video oluşturma
APIMaster aracılığıyla Sora 2 ile videolar oluşturun. Desteklenen modeller: sora-2, sora-2-pro. sora adı sora-2 ile eşlenir.
Temel URL:
https://apimaster.ai/v1https://apimaster.ai/v1adresidir.https://apimaster.ai/v1/videos/...kullanın — başka bir/v1eklemeyin.
Fiyatlandırma (resmi fiyatın %20 indirimi, saniye başına)
Faturalama, süre (saniye) × saniye başına ücret şeklindedir.
| Model | Çözünürlük | Resmi | APIMaster |
|---|---|---|---|
sora-2 |
720p | $0,10 / sn | $0,08 / sn |
sora-2-pro |
720p | $0,30 / sn | $0,24 / sn |
sora-2-pro |
1024p | $0,50 / sn | $0,40 / sn |
sora-2-pro |
1080p | $0,70 / sn | $0,56 / sn |
Örnek: 4 saniye sora-2 720p'de ≈ $0,32 ($0,08 × 4).
Görev gönderme
İki giriş noktası — ikisinden birini kullanın.
Seçenek A (önerilir): yerel JSON
POST https://apimaster.ai/v1/videos/generations
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
model |
string | Evet | sora-2 / sora-2-pro (veya sora) |
prompt |
string | Evet | Video açıklaması |
duration |
integer | Hayır | Yaygın: 4 / 8 / 12 / 16 / 20, varsayılan 4 |
resolution |
string | Hayır | sora-2: 720p; sora-2-pro: ayrıca 1024p / 1080p, varsayılan 720p |
aspect_ratio |
string | Hayır | 16:9 / landscape veya 9:16 / portrait, varsayılan 16:9 |
image_urls |
string[] | Hayır | Görselden videoya; 1 herkese açık URL önerilir |
curl -s "https://apimaster.ai/v1/videos/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A waterfall forming a rainbow, cinematic",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
Gönderme yanıtı
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_xxxxxxxx"
}
]
}
Görselden videoya için aspect_ratio değerini açıkça ayarlayın (portre → 9:16). Varsayılan 16:9.
Seçenek B: OpenAI Video uyumlu
POST https://apimaster.ai/v1/videos (JSON veya multipart)
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
model |
string | Evet | sora-2 / sora-2-pro (veya sora) |
prompt |
string | Evet | Video açıklaması |
seconds |
string | Hayır | Süre, örn. "4"; duration tamsayı da çalışır, varsayılan 4 |
size |
string | Hayır | Piksel boyutu — çözünürlük + yönelim (aşağıdaki tablo), varsayılan 720x1280 |
images |
string[] | Hayır | Görselden videoya; en fazla 1 URL. input_reference (tek) de çalışır |
size değerleri
| Model | Yatay (16:9) | Dikey (9:16) |
|---|---|---|
sora-2 |
1280x720 (720p) |
720x1280 (720p) |
sora-2-pro |
1280x720 (720p) / 1792x1024 (1024p) |
720x1280 (720p) / 1024x1792 (1024p) |
Geçersiz
size(örn.1920x1080)400 invalid_sizedöndürür. OpenAI yol maksimum 1024p; 1080p içinresolution: "1080p"ile Seçenek A'yı kullanın.
curl -s "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A waterfall forming a rainbow, cinematic",
"seconds": "4",
"size": "1280x720"
}'
Gönderme yanıtı
{
"id": "task_xxxxxxxx",
"object": "video",
"model": "sora-2",
"status": "queued"
}
Yoklama ve indirme için her iki uç noktadan task_id / id kullanın.
Görev durumunu yoklama
GET https://apimaster.ai/v1/videos/{task_id}
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" \
-H "Authorization: Bearer YOUR_API_KEY"
Tamamlanmış örnek:
{
"id": "task_xxxxxxxx",
"status": "completed",
"url": "https://apimaster.ai/v1/videos/task_xxxxxxxx/content"
}
MP4'ü
https://apimaster.ai/v1/videos/{task_id}/contentüzerinden indirin.
Video indirme
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" \
-o output.mp4
Görselden videoya örnekleri
Seçenek A:
curl -s "https://apimaster.ai/v1/videos/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "Slow push-in, gentle breeze in the hair",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "9:16",
"image_urls": ["https://example.com/reference.jpg"]
}'
Seçenek B (images alanı):
curl -s "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "Slow push-in, gentle breeze in the hair",
"seconds": "8",
"images": ["https://example.com/reference.jpg"]
}'
Yoklama ipuçları
- Gönderdikten sonra 10–20 saniye bekleyin; ardından her 3–5 saniyede bir yoklama yapın
- Tipik süre: 1–3 dakika
- Tamamlandıktan sonra MP4'ü hemen kaydedin
Hata kodları
| kod | Anlamı |
|---|---|
| 400 | Geçersiz parametreler (örn. invalid_size) |
| 401 | Geçersiz API anahtarı |
| 402 | Yetersiz bakiye |
| 429 | Hız sınırı aşıldı |
| 500 / 502 | Geçici hata, tekrar deneyin |