Sora 2 Pro API

Sora 2 Pro API'yi Entegre Edin

Öngörülebilir yoklama ve kredi kontrolü ile metinden videoya, görüntüden videoya ve storyboard iş akışları oluşturun.

Sora 2 Pro API'nin sunduğu özellikler

Üretime hazır Sora 2 Pro pipeline'ları başlatmak için ihtiyacınız olan her şey.

Beş model varyantı

Kalite ve maliyete göre sora-2 metin/görüntü veya sora-2-pro metin/görüntü/storyboard seçin.

Storyboard desteği

shots[] ve sahne başına sürelerle çoklu çekim anlatıları tanımlayın.

Birleşik yanıtlar

Tüm uç noktalar, hatalarda HTTP durumu 200 olsa bile code/message/data döndürür.

Kimlik Doğrulama ve Temel URL

Temel URL: https://freesoragenerator.com. Bir API anahtarı veya oturum açmış oturum çerezi ile kimlik doğrulayın.

  • Authorization: Bearer [TOKEN] (API anahtarı sk- veya JWT) veya bir oturum çerezi gönderin.
  • POST gövdeleriyle Content-Type: application/json gönderin.
  • Çoğu hata hala HTTP 200 döndürür; her zaman code alanını kontrol edin.

Temel uç noktalar

/sora-pro ile görevler oluşturun, ardından durum için check-result'u yoklayın.

Oluşturma görevi oluştur

Girdiyi doğrulayın, kredileri düşün, bir görev oluşturun ve taskId döndürün.

Metot: POSTYol: /api/v1/video/sora-pro

Payload parametreleri

  • Gerekli. sora-2-text-to-video, sora-2-image-to-video, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard'dan biri.
  • Koşullu. sora-2-pro-storyboard hariç tüm modeller için gereklidir.
  • Koşullu. data:image/png;base64,... gibi Base64 veri URL'si. imageUrl yoksa görüntüden videoya için gereklidir.
  • Koşullu. imageData sağlanmadığında kullanılan genel görüntü URL'si.
  • İsteğe bağlı. portrait veya landscape. Varsayılan: landscape.
  • İsteğe bağlı. 10, 15 veya 25 (yalnızca storyboard). Varsayılanlar modele göre değişir.
  • İsteğe bağlı. standard veya high. Yalnızca Pro metin/görüntü modelleri için.
  • İsteğe bağlı. Storyboard olmayan modeller için filigranı kaldırın. Varsayılan: true.
  • Koşullu. sora-2-pro-storyboard için gereklidir. '{ Scene, duration }' dizisi.

Notlar

  • Her ikisi de sağlandığında imageData, imageUrl'den önceliklidir.
  • prompt, storyboard için isteğe bağlıdır ve sağlayıcıya gönderilmez; içerik için shots kullanın.
  • nFrames, model başına izin verilen değerlere normalleştirilir.
  • removeWatermark, storyboard olmayan modeller için varsayılan olarak true'dur.
  • shots, Scene (büyük S) ve duration > 0 içermelidir.

Örnek istekler

Metinden videoya
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "A cinematic shot of a futuristic city at sunset.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true
  }'
Görüntüden videoya
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-image-to-video",
    "prompt": "Turn this image into a dynamic 10s clip.",
    "imageUrl": "https://example.com/reference.png",
    "aspectRatio": "portrait",
    "nFrames": "10"
  }'
Storyboard
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-storyboard",
    "shots": [
      { "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
      { "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
    ],
    "aspectRatio": "landscape",
    "nFrames": "10"
  }'

Örnek yanıt

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

Görev durumunu sorgula

taskId ile durum, ilerleme ve sonuç URL'lerini alın.

Metot: POSTYol: /api/video-generations/check-result

Payload parametreleri

  • Gerekli. Oluşturma tarafından döndürülen taskId.

Notlar

  • Durum değerleri: pending | running | succeeded | failed | cancelled.
  • result_url ve result_urls, hazır olduğunda son video bağlantılarını döndürür.

Örnek istek

curl -X POST https://freesoragenerator.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "281e5b0*********************f39b9"
  }'

Örnek yanıt

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null
  }
}

Kullanıcı kredilerini al

Görev göndermeden önce mevcut kredi bakiyesini kontrol edin.

Metot: POSTYol: /api/get-user-credits

Notlar

  • İsteğe bağlı uç nokta; ön kontroller için kullanışlıdır.
  • left_credits ve is_vip bayraklarını döndürür.

Örnek istek

curl -X POST https://freesoragenerator.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Örnek yanıt

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": false
  }
}

Yaygın hata kodları

Hatalar, yanıt gövdesindeki code alanı aracılığıyla gösterilir.

  • 401: Yetkisiz
  • 402: Yetersiz kredi
  • -1: Geçersiz model parametresi
  • -1: Prompt gereklidir
  • -1: Görüntüden videoya için görüntü gereklidir
  • -1: Storyboard için shots gereklidir
  • -1: Görüntü yüklenemedi
  • -1: Video oluşturma kaydı oluşturulamadı

Kredi referansı

Krediler model, boyut ve nFrames'e göre değişir. Bu tabloyu temel olarak kullanın.

ModelParametrelerKrediler
sora-2-text-to-video1020
sora-2-text-to-video1530
sora-2-image-to-video1020
sora-2-image-to-video1530
sora-2-pro-text-to-videostandard + 10375
sora-2-pro-text-to-videostandard + 15675
sora-2-pro-text-to-videohigh + 10825
sora-2-pro-text-to-videohigh + 151.575
sora-2-pro-image-to-videostandard + 10375
sora-2-pro-image-to-videostandard + 15675
sora-2-pro-image-to-videohigh + 10825
sora-2-pro-image-to-videohigh + 151.575
sora-2-pro-storyboard10375
sora-2-pro-storyboard15675
sora-2-pro-storyboard25675

1. Görevi oluşturun

Modeliniz ve payload'ınızla POST /api/v1/video/sora-pro gönderin.

2. İlerlemeyi takip edin

Durum succeeded veya failed olana kadar /api/video-generations/check-result'u yoklayın.

3. Kredileri doğrulayın

Büyük gruplar göndermeden önce isteğe bağlı olarak /api/get-user-credits'i çağırın.

Sıkça sorulan sorular

API anahtarları veya oturum çerezleri kullanabilir miyim?

Evet. Authorization: Bearer [TOKEN] (API anahtarı veya JWT) veya oturum açmış bir oturum çerezi gönderin.

Storyboard çekimlerini nasıl biçimlendiririm?

shots'ı Scene'in büyük harfle başladığı ve duration'ın saniye cinsinden olduğu '{ Scene, duration }' dizisi olarak sağlayın.

Krediler neden modele göre farklılık gösteriyor?

Krediler tüm modeller için nFrames ile ölçeklenir; Pro modeller ayrıca boyuta göre de değişir.

Faydalı kaynaklar

Sora 2 Pro API ile başlayın

Bir API anahtarı oluşturun ve bugün ilk Sora 2 Pro iş akışınızı başlatın.