เอกสาร API สำหรับนักพัฒนา

สร้างวิดีโออธิบายแบบแอนิเมชันด้วย API ของ DeepManim

เริ่มต้นใช้งาน

API ของ DeepManim ช่วยให้สร้างวิดีโอแอนิเมชันเพื่อการสอนได้ด้วยโปรแกรม สร้างจากพรอมต์ ปรับปรุงทีละขั้น และเพิ่มเสียงบรรยายผ่าน REST API ที่ใช้งานง่าย

URL หลัก: https://api.deepmanim.com/api/v1

หมายเหตุสำคัญ

  • การยืนยันตัวตน ทุกคำขอต้องมีคีย์ API ในส่วนหัว Authorization
  • เครดิต การสร้างวิดีโอใช้เครดิตตามค่าที่ตั้งไว้ของโมเดล
  • งานแบบอะซิงโครนัส คำขอสร้างจะคืน job_id ให้ตรวจสอบสถานะภายหลัง

การยืนยันตัวตน

คำขอ API ทั้งหมดต้องใช้คีย์ API สร้างคีย์ได้ที่ การตั้งค่า → คีย์ API ในแอป

ต้องซื้อเครดิตก่อน เปิดใช้ API สำหรับผู้ใช้ที่เคยซื้อเครดิตอย่างน้อยหนึ่งครั้ง เครดิตฟรีอย่างเดียวไม่เพียงพอ

ใส่คีย์ของคุณในส่วนหัว Authorization:

Authorization: Bearer dm_k_your_api_key_here

เก็บคีย์ API เป็นความลับ อย่าแชร์คีย์ในคลังสาธารณะหรือแอปฝั่งไคลเอนต์

เริ่มด่วน

สร้างวิดีโอในสามขั้นตอน: สร้างงาน ตรวจสอบจนเสร็จ แล้วรับผลลัพธ์

1. สร้างวิดีโอ

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "อธิบายว่าการสังเคราะห์แสงทำงานอย่างไร", "preferred_locale": "th"}'

2. ตรวจสอบจนเสร็จ

curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer dm_k_your_key"

# คำตอบประกอบด้วย:
#   status: "pending" | "running" | "completed" | "failed"
#   phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done"
#   estimated_time_remaining_seconds: 285

3. รับผลลัพธ์

# เมื่อสถานะเป็น completed คำตอบจะประกอบด้วย:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "แอนิเมชันที่อธิบายการสังเคราะห์แสง...",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "การหายใจระดับเซลล์เกี่ยวข้องกับการสังเคราะห์แสงอย่างไร"
  }
}

ปลายทาง API

การสร้างวิดีโอ

งาน

เซสชัน

ข้อความ

บัญชี

เครดิตและราคา

การเรียก API แต่ละครั้งที่สร้างงานจะหักเครดิตจากยอดของคุณ:

การทำงานค่าใช้จ่าย
สร้างวิดีโอเริ่มต้นที่ 1.5 เครดิต
ปรับปรุงวิดีโอเริ่มต้นที่ 1.5 เครดิต
เพิ่มเสียง1 เครดิต
ปรับปรุงเสียงบรรยาย1 เครดิต

ค่าใช้จ่ายในการสร้างและปรับปรุงขึ้นกับค่าที่ตั้งไว้ ปัจจุบันอยู่ที่ 1.5–70 เครดิต การอ่านเซสชัน ข้อความ สถานะงาน และข้อมูลบัญชีฟรีและไม่หักเครดิต

คำตอบข้อผิดพลาด

สถานะความหมาย
401คีย์ API หายไปหรือไม่ถูกต้อง
402เครดิตไม่เพียงพอ
404ไม่พบทรัพยากร (เซสชัน ข้อความ หรืองาน)
400คำขอไม่ถูกต้อง (เช่น ไม่มีวิดีโอให้ปรับปรุง หรือไม่มีเสียงบรรยายให้แก้)
เอกสาร API สำหรับนักพัฒนา | DeepManim