API DeepManim | DeepManim

Bắt đầu với API

Dùng API DeepManim để tạo video giải thích hoạt họa, cải thiện chúng và thêm thuyết minh từ ứng dụng của bạn.

URL cơ sở https://api.deepmanim.com/api/v1

Lưu ý quan trọng

Bất đồng bộ Các yêu cầu tạo trả về job_id; hãy thăm dò tác vụ để nhận kết quả.
Tín dụng Mỗi thao tác tạo hoặc hậu kỳ tiêu tốn tín dụng trong tài khoản của bạn.
Ngôn ngữ Đặt preferred_locale để nhận nội dung và thuyết minh bằng ngôn ngữ mong muốn.

Xác thực

Xác thực mọi yêu cầu bằng khóa API của bạn.

Tín dụng Tác vụ chỉ chạy khi tài khoản còn đủ tín dụng.

Tạo khóa trong phần Cài đặt rồi gửi khóa dưới dạng Bearer token.

Authorization: Bearer dm_k_your_api_key_here

Giữ bí mật khóa Không đưa khóa API vào mã phía trình duyệt hoặc kho mã công khai.

Bắt đầu nhanh

Tạo một video và theo dõi tác vụ chỉ với vài lệnh.

Gửi yêu cầu POST đến /generate

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Giải thích định lý Pythagore", "preferred_locale": "vi"}'

Thăm dò /jobs/{job_id} cho đến khi hoàn tất

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

# Phản hồi:
#   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

Đọc video_url trong kết quả

# Đã hoàn tất:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "Một hoạt họa về định lý Pythagore...",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "Định lý này có ứng dụng thực tế nào?"
  }
}

Endpoint

Tạo video

Tác vụ

Phiên

Tin nhắn

Tài khoản

Tín dụng và chi phí

Chi phí phụ thuộc vào thao tác và chất lượng được yêu cầu.

Thao tác	Chi phí
Tạo	Chi phí khởi điểm
Cải thiện	Chi phí khởi điểm
Âm thanh	1 tín dụng
Cải thiện thuyết minh	1 tín dụng

Chi phí thực tế có thể thay đổi theo độ dài và cấu hình video.

Mã lỗi

Mã trạng thái	Ý nghĩa
401	Thiếu hoặc sai khóa API.
402	Tài khoản không đủ tín dụng.
404	Không tìm thấy phiên, tác vụ hoặc tin nhắn.
400	Thân yêu cầu không hợp lệ.