소라 2 API 위에 구축

페이로드 매개변수

• 필수. 필요한 모델 변형을 지정하기 위해 "sora-2" 또는 "sora-2-pro"를 사용하세요.
• 필수. Sora가 생성하기를 원하는 장면에 대한 자연어 설명입니다.
• 선택 사항(권장). 이미지-비디오 모드를 위한 "data:image/*;base64," 접두사가 있는 Base64 데이터 URL.
• 선택 사항. 레거시 참조 이미지 URL; 여전히 지원되지만 imageData보다 우선순위가 낮습니다.
• 선택 사항. 지원되는 값: "9:16" (기본값) 또는 "16:9".
• 선택 사항. 비디오를 공개적으로 표시할지 여부; 기본값은 true입니다.
• 선택 사항(VIP 전용). 연속/리믹스 기능을 위한 대상 비디오 pid.
• 선택 사항(VIP 전용). 캐릭터 제어 배열; 각 항목에는 url 및 타임스탬프가 포함됩니다.
• 선택 사항. 작업이 성공할 때 최종 결과 페이로드를 수신하는 HTTPS 엔드포인트.

샘플 요청

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-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

샘플 응답

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

페이로드 매개변수

• 필수. 생성 작업을 생성할 때 반환된 식별자입니다.

샘플 요청

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