เริ่มต้นใช้งาน
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 | คำขอไม่ถูกต้อง (เช่น ไม่มีวิดีโอให้ปรับปรุง หรือไม่มีเสียงบรรยายให้แก้) |