ข้ามไปยังเนื้อหา

API สร้างวิดีโอ AI

ส่ง prompt ไป ได้วิดีโอที่เสร็จแล้วกลับมา Yoh เขียนบท คัดตัวละครที่หน้าตาคงเดิม ใส่เสียงพากย์ เพลง และซับ แล้วเรนเดอร์เป็น MP4 หรือจะคุมแต่ละขั้นเองก็ได้ ทั้งเรื่อง ซีรีส์ คลิป ตัวละคร ไทม์ไลน์ และการเรนเดอร์

วิดีโอแรกในสามคำขอ

  1. สร้าง key

    ล็อกอิน เปิด Settings → API keys แล้วสร้าง key ที่มี stories:generate และ stories:read key จะแสดงแค่ครั้งเดียว เก็บไว้เป็น secret ฝั่ง server ทดสอบได้ดังนี้:

    curl https://www.yoh.app/api/v1/credits \
      -H "Authorization: Bearer $YOH_API_KEY"
  2. สร้างวิดีโอ

    X-Max-Generation-Credits คือการยินยอมของคุณ: จำนวนเครดิตสูงสุดที่คุณยอมรับสำหรับคำขอนี้ ถ้าราคาสูงกว่า จะได้ HTTP 409 พร้อมใบเสนอราคาและไม่มีการเรียกเก็บใดๆ ใช้ Idempotency-Key เดิมเพื่อ retry ได้อย่างปลอดภัย

    curl -X POST https://www.yoh.app/api/v1/stories/generate \
      -H "Authorization: Bearer $YOH_API_KEY" \
      -H "X-Max-Generation-Credits: 500" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: my-first-video-1" \
      -d '{ "prompt": "A dragon teaches a young knight how to fly", "contentType": "cinematic_story", "aspectRatio": "16:9", "scope": "full", "renderVideo": true }'
  3. Poll สถานะงาน

    เช็กทุก 20 วินาทีจนสถานะเป็น completed คำตอบจะมี storyId และ videoUrl ของไฟล์ MP4

    curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \
      -H "Authorization: Bearer $YOH_API_KEY"

ทำไมถึงใช้งานได้ดี

คุมได้ทุกอย่างเมื่อต้องการ

สร้างซีรีส์และนักแสดงครั้งเดียว แล้วสร้างตอนต่างๆ ในซีรีส์นั้น แก้คลิป สร้างภาพหรือวิดีโอใหม่เฉพาะคลิปเดียว เริ่มจากวิดีโอที่คุณอัปโหลดเอง และเรนเดอร์ไทม์ไลน์ที่คุณเลือก

ค่าใช้จ่ายที่คาดการณ์ได้

ทุกคำขอที่มีค่าใช้จ่ายต้องมีเพดานเครดิตหรือใบเสนอราคาที่ยอมรับแล้ว พรีวิวฟรี (estimate, quoteOnly, dryRun) บอกราคาก่อนที่อะไรจะเริ่ม

ออกแบบมาให้ retry ได้

มี idempotency key สำหรับการสร้าง durable job ที่ poll และยกเลิกได้ และสถานะสิ้นสุดที่ชัดเจน

อยากใช้ agent มากกว่า?

บัญชีและ scope เดียวกันใช้ผ่าน MCP ได้ Claude หรือ Codex จึงเรียก Yoh แทนคุณได้

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

มี API สำหรับสร้างวิดีโอ AI จากข้อความไหม

มี POST /api/v1/stories/generate รับ prompt แล้วคืนค่าเป็น job เมื่อเสร็จ คุณจะได้ MP4 ที่เรนเดอร์แล้วพร้อมบท ตัวละคร เสียงพากย์ เพลง และซับ

API คิดราคาอย่างไร

ใช้เครดิต Yoh เดียวกับในแอป ทุกคำขอที่มีค่าใช้จ่ายต้องระบุเครดิตสูงสุดที่คุณยอมรับ และขอราคาที่แน่นอนก่อนได้จาก estimate endpoint ที่ใช้ฟรี

ใช้ตัวละครเดิมในหลายวิดีโอได้ไหม

ได้ สร้างซีรีส์พร้อมตัวละครครั้งเดียว แล้วสร้างตอนต่างๆ ในซีรีส์นั้น ทุกตอนจะใช้นักแสดงชุดเดิม

ข้อมูลอ้างอิงฉบับเต็มอยู่ที่ไหน

เอกสารแสดงทุก endpoint, scope และ error พร้อม playground ให้ทดลองจริง

ข้อมูลอ้างอิงฉบับเต็ม: เอกสาร Yoh · ราคา · OpenAPI 3.1

วิธีเชื่อมต่ออื่นๆ