跳到正文
DER.run
打开工作室

API

AI 图片与视频生成 API

工作室里的模型和工具，都可以用 API 密钥通过 HTTPS 调用：读取模型目录、提交任务、轮询状态、下载结果。也可以通过 MCP 把 DER 接入你的 AI 智能体。

获取 API 密钥连接 AI 智能体
  • 身份验证Bearer API 密钥
  • 模型与工具目录里有 52 个
  • 轮询每 5–30 秒
  • 价格1 积分 = US$0.01

两种接入方式

写代码用 REST，智能体用 MCP

REST API

https://api.der.run/v1

给你自己的代码用。提交任务，轮询状态，下载结果。

  • GET/v1/capabilities每个模型的参数、上传位、计价方式和轮询间隔
  • POST/v1/quotes提交之前先给任务报价
  • POST/v1/uploads开始上传，然后把文件 PUT 到它返回的地址
  • POST/v1/uploads/{id}/complete完成上传，拿到要填进 inputs 的 asset id
  • POST/v1/jobs提交任务 · 必须带 Idempotency-Key
  • GET/v1/jobs你的任务，从新到旧，每页最多 100 个
  • GET/v1/jobs/{id}任务的状态
  • GET/v1/jobs/{id}/assets/{index}通过一条约一小时内有效的私有链接下载输出

MCP 服务器与 DER skill

https://api.der.run/mcp

给 Claude Code、Cursor、Codex 这类 AI 智能体用。添加地址，用你的 DER 账号登录，然后用平常的话提要求。

  • der_list_models模型、价格和限制
  • der_quote运行前先询价（不扣积分）
  • der_create_job发起视频、图片、AIdol、换脸或音乐任务
  • der_get_job状态和结果链接
  • der_get_results下载链接
  • MCP 服务器里还有 13 个工具
设置你的 AI 智能体

身份验证

一把密钥，代表你的整个账号

把你的 API 密钥作为 Bearer token 发送。密钥代表你的账号：同一份积分，同一个等级。密钥最长有效 366 天，在“API keys”（API 密钥）里创建和撤销。最多同时有 10 把。

HTTP 头
# 每个请求都要带
Authorization: Bearer der_user_…

快速开始

三步完成第一个任务

  1. 创建 API 密钥

    在工作室的“API keys”里创建。密钥只显示一次，要保存在安全的地方。

    打开“API keys”

  2. 读取模型目录

    GET /v1/capabilities 会列出每个模型的参数、上传位、计价方式和轮询间隔。

    终端
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. 提交并轮询

    先上传你的照片，然后带上 Idempotency-Key 请求 POST /v1/jobs，再轮询 GET /v1/jobs/{id}，直到任务结束。用同一个 key 再发一次，返回的是同一个任务。

    终端
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

须知

上线之前

  • 结果是私有的

    通过 REST 下载输出要带上你的密钥：GET /v1/jobs/{id}/assets/{index} 会把你带到一条约一小时内有效的私有链接。没有公开链接，MCP 工具给出的也是同一种链接。结果和上传的文件保存 7 天，之后自动删除。

  • 列表分页返回

    GET /v1/jobs 最多返回 100 个任务，从新到旧。把 next_before 作为 before 传回去可以取更早的，还可以按 model、output 或 state 筛选。

  • 价格

    有些模型在目录里是固定价格，其余的在提交时计价。POST /v1/quotes 可以先告诉你价格。

  • 等级

    有些模型需要 Pro 或 Max 等级的账号。等级不够的账号请求这些模型，会收到 403。

  • 同一份积分

    API 用的积分和工作室是同一份。任务失败会自动退还积分。

  • 按模型的节奏轮询

    每个模型在目录里都有自己的 poll_seconds。请求太频繁会收到 429，并带有 Retry-After 头。

给 AI 智能体用

在 Claude Code、Cursor 或 Codex 里用 DER

一条命令就能连上。同样的模型，同一份积分，结果也会出现在工作室里。

打开 AI 智能体指南