基於 Sora 2 API 構建

有效負載參數

• model: Ɛhia. Tɔɔ model string a ɛwɔ API reference no mu kɔɔ model variant a ɛhia.
• prompt: Ɛhia. Nsɛnkyerɛw a ɛkyerɛkyerɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ dwɛ.
• imageData: 可選（推薦）。帶有前綴 "data:image/*;base64," 的 Base64 數據 URL，用於圖像到視頻模式。
• url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
• aspectRatio: 可選。支持的值："9:16"（默認）或 "16:9"。
• duration: Optional. Only for "sora-2-stable"; choose 10 or 15 seconds (default 10).
• isPublic: 可選。是否公開顯示視頻；默認為 true。
• remixTargetId: 可選（僅限 VIP）。用於繼續/混音功能的目標視頻 pid。
• characters: 可選（僅限 VIP）。角色控制數組；每個項目包括 url 和時間戳。

示例請求

curl -X POST https://freesoragenerator.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-stable",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "duration": 15,
    "isPublic": true
  }'

示例響應

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890"
  }
}

有效負載參數

• 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": "task_1234567890"
  }'

示例響應

{
  "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,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

示例請求

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_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}