API 文档

DeepManim 公共 API v1

开始使用

DeepManim API 让你可以通过编程生成教育动画视频。从文字提示词创建视频，逐步改进它们并添加旁白——全部通过简单的 REST API 完成。

基础 URL： https://api.deepmanim.com/api/v1

重要说明

  • 生成时的音频： 通过 /generate 生成新视频时，默认会包含音频旁白。
  • 修改时没有音频： 通过 /improve 改进视频时，结果不包含音频。请先完成所有修改，满意后再通过 /audio 添加音频。
  • 预计时间： 视频生成大约需要 6 分钟。任务响应中的 estimated_time_remaining_seconds 字段会显示实时倒计时。

身份验证

所有 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": "zh-CN"}'

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. 获取结果

# 当 status 为 "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 调用都会从余额中扣除点数：

操作费用
生成视频最低 1.5 点数
改进视频最低 1.5 点数
添加音频1 点数
改进旁白1 点数

生成和改进的费用取决于所选预设，目前为 1.5 到 70 点数。读取会话、消息、任务状态和账户信息免费，不会扣除点数。

错误响应

状态含义
401缺少或无效的 API 密钥
402点数不足
404未找到资源（会话、消息或任务）
400请求无效（例如没有可改进的视频，或没有可优化的旁白）
API 文档 | DeepManim