Sora 2 Pro API を統合する

ペイロードパラメータ

• model: 必須。次のいずれか: sora-2-text-to-video、sora-2-image-to-video、sora-2-text-to-video-stable、sora-2-image-to-video-stable、sora-2-pro-text-to-video、sora-2-pro-image-to-video、sora-2-pro-storyboard。
• prompt: 条件付き。sora-2-pro-storyboard 以外のすべてのモデルで必須。
• imageData: 条件付き。data:image/png;base64,... のような Base64 データ URL。imageUrl がない場合、image-to-video で必須。
• imageUrl: 条件付き。imageData が提供されていない場合に使用される公開画像 URL。
• aspectRatio: オプション。portrait または landscape。デフォルト: landscape。
• nFrames: オプション。10、15、または 25（ストーリーボードのみ）。デフォルトはモデルによって異なります。
• size: オプション。standard または high。Pro テキスト/画像モデルのみ。
• removeWatermark: オプション。非ストーリーボードモデルのウォーターマークを削除。デフォルト: true。
• isPublic: 任意。動画を公開表示するかどうか。デフォルトは true。
• shots: 条件付き。sora-2-pro-storyboard で必須。'{ Scene, duration }' の配列。

リクエスト例

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,
    "isPublic": true
  }'

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-stable",
    "prompt": "Turn this image into a dynamic 15s clip.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "portrait",
    "nFrames": "15"
  }'

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"
  }'

レスポンス例

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

ペイロードパラメータ

• taskId: 必須。create で返された taskId。

リクエスト例

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"
  }'

レスポンス例

{
  "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
  }
}

リクエスト例

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

レスポンス例

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