Sora 2 API

สร้างบน Sora 2 API

จัดส่งประสบการณ์ข้อความเป็นวิดีโอที่สนับสนุนโดย OpenAI Sora 2 และ Sora Pro ตรวจสอบสิทธิ์ด้วย API keys ตรวจสอบสถานะงาน และส่งมอบวิดีโอสุดท้ายในไม่กี่นาที

ทำไมทีมถึงพึ่งพา Sora 2 API

ส่งมอบเวิร์กโฟลว์การสร้างวิดีโอที่ยืดหยุ่นด้วยการโพลที่คาดเดาได้ 20 คำขอพร้อมกัน และการอัปโหลดที่เก็บข้อมูลอัตโนมัติ

Sora 2 + Sora Pro

เลือกสตริงโมเดลที่ตรงกับคุณภาพและความต้องการด้านต้นทุนของคุณ: sora-2 หรือ sora-2-pro

การตรวจสอบที่คาดการณ์ได้

สร้างงาน จากนั้นตรวจสอบผลลัพธ์เพื่อให้สถานะและความก้าวหน้าอยู่ในความสอดคล้องโดยไม่ต้องใช้ SSE

20 คำขอพร้อมกัน

ประมวลผลงานสร้างวิดีโอได้สูงสุด 20 งานพร้อมกัน ติดต่อเราสำหรับขีดจำกัดที่สูงขึ้น

การตรวจสอบสิทธิ์ & URL พื้นฐาน

ทุก endpoint จะอยู่ภายใต้ https://freesoragenerator.com/api ส่ง API key ที่สร้างในคอนโซลผ่าน header Authorization

  • ส่ง header Authorization: Bearer YOUR_API_KEY กับทุกคำขอ
  • ใช้ Content-Type: application/json เมื่อโพสต์ข้อมูล
  • การร้องขอการสร้างแต่ละครั้งจะหัก 20 เครดิต (sora-2) หรือ 30 เครดิต (sora-2-pro); งานที่ล้มเหลวจะได้รับเครดิตคืนโดยอัตโนมัติ

Endpoints หลัก

เริ่มต้นด้วยการสร้างงานการสร้าง จากนั้นตรวจสอบหรือฟังผลลัพธ์

สร้างวิดีโอ Sora 2

เริ่มงานการสร้าง Sora 2 หรือ Sora Pro ด้วยคำแนะนำข้อความเป็นวิดีโอหรือภาพเป็นวิดีโอ

วิธีการ: POSTเส้นทาง: /api/v1/video/sora-video

พารามิเตอร์ข้อมูล

  • จำเป็นต้องใช้ ใช้ "sora-2" หรือ "sora-2-pro" เพื่อกำหนดเป้าหมายโมเดลที่คุณต้องการ
  • จำเป็นต้องใช้ คำอธิบายด้วยภาษาธรรมชาติของฉากที่คุณต้องการให้ Sora สร้าง
  • ไม่บังคับ (แนะนำ) URL ข้อมูล Base64 พร้อมคำนำหน้า "data:image/*;base64," สำหรับโหมดภาพเป็นวิดีโอ
  • ไม่บังคับ URL ภาพอ้างอิงแบบเดิม ยังคงรองรับแต่มีลำดับความสำคัญต่ำกว่า imageData
  • ไม่บังคับ ค่าที่รองรับ: "9:16" (ค่าเริ่มต้น) หรือ "16:9"
  • ไม่บังคับ แสดงวิดีโอต่อสาธารณะหรือไม่ ค่าเริ่มต้นคือ true
  • ไม่บังคับ (VIP เท่านั้น) pid วิดีโอเป้าหมายสำหรับคุณสมบัติต่อเนื่อง/รีมิกซ์
  • ไม่บังคับ (VIP เท่านั้น) อาร์เรย์ควบคุมตัวละคร แต่ละรายการรวม url และ timestamps
  • ไม่บังคับ HTTPS endpoint ที่รับข้อมูลการส่งมอบสุดท้ายเมื่อการทำงานสำเร็จ

หมายเหตุ

  • การตอบกลับจะถูกส่งกลับทันทีพร้อม taskId; ตรวจสอบ check-result จนกว่าสถานะจะสำเร็จหรือล้มเหลว
  • ให้ webHook เพื่อรับข้อมูลการส่งมอบสุดท้ายโดยไม่ต้องรันวงจรการตรวจสอบ

ตัวอย่างคำขอ

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

ตรวจสอบผลลัพธ์การสร้าง

ตรวจสอบสถานะล่าสุดสำหรับงานการสร้างเพื่อติดตามความก้าวหน้าและดึงผลลัพธ์

วิธีการ: POSTเส้นทาง: /api/video-generations/check-result

พารามิเตอร์ข้อมูล

  • จำเป็นต้องใช้ หมายเลขประจำตัวที่ส่งคืนเมื่อคุณสร้างงานการสร้าง

หมายเหตุ

  • endpoint จะตรวจสอบว่างานเป็นของบัญชีของคุณก่อนที่จะส่งคืนข้อมูล
  • งานที่ล้มเหลวจะคืนเครดิตโดยอัตโนมัติและเปิดเผยข้อมูลการคืนเงินในข้อมูลการตอบกลับ

ตัวอย่างคำขอ

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

รับเครดิตผู้ใช้และสถานะ VIP

สอบถามเครดิตที่มีอยู่ของผู้ใช้ปัจจุบันและสถานะสมาชิก VIP

วิธีการ: POSTเส้นทาง: /api/get-user-credits

หมายเหตุ

  • ต้องการเซสชันเข้าสู่ระบบที่ถูกต้องหรือโทเค็น API เพื่อเข้าถึงข้อมูลผู้ใช้
  • ส่งคืนฟิลด์ left_credits, is_recharged, is_pro และ is_vip สถานะ

ตัวอย่างคำขอ

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

1. สร้างงาน

ส่งคำขอ Sora2 API พร้อมคำแนะนำและ URL webhook ที่ไม่บังคับ จากนั้นเก็บ taskId ที่ส่งคืน

2. ติดตามความก้าวหน้า

สมัครสมาชิกกับเหตุการณ์สตรีมหรือเรียก endpoint check-result จนกว่าสถานะจะสำเร็จหรือล้มเหลว

3. ส่งมอบวิดีโอ

ใช้ URL ที่เก็บข้อมูลใน result_url/result_urls เพื่อให้บริการหรือดาวน์โหลดวิดีโอที่สร้าง

คำถามที่พบบ่อย

ฉันจะตรวจสอบสิทธิ์คำขอของฉันได้อย่างไร?

สร้าง API key ในคอนโซล จากนั้นรวมไว้ใน Authorization: Bearer YOUR_API_KEY คีย์สามารถหมุนเวียนได้ตลอดเวลา

ฉันควรตรวจสอบผลลัพธ์อย่างไร?

หลังจากเรียกสร้าง ให้เก็บ taskId เรียก /api/video-generations/check-result ทุก 3-5 วินาทีจนกว่าสถานะจะสำเร็จหรือล้มเหลว จากนั้นใช้ result_url/result_urls

เครดิตจะถูกจัดการอย่างไรสำหรับความล้มเหลว?

เราจะคืนเครดิตโดยอัตโนมัติเมื่อการทำงานล้มเหลวและส่งคืน refund_trans_no พร้อม credits_refunded=true ในข้อมูลการตรวจสอบผลลัพธ์เพื่อการตรวจสอบ

แหล่งข้อมูลที่เป็นประโยชน์

เปิดตัวด้วย Sora2 API วันนี้

สร้าง API key ของคุณและเริ่มสร้างวิดีโอ AI ที่มีคุณภาพในไม่กี่นาที