跳至主要內容
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 代理指南