本文へスキップ
DER.run
スタジオを開く

API

画像・動画生成API

スタジオのモデルとツールは、APIキーを使ってHTTPS経由で利用できます。モデルカタログの取得、ジョブの送信、ポーリング、結果のダウンロードができます。MCPでDERをAIエージェントに接続することもできます。

APIキーを取得AIエージェントを接続
  • 認証Bearer APIキー
  • モデルとツールカタログに52種類
  • ポーリング5〜30秒ごと
  • 料金1クレジット = $0.01

2つの使い方

コードからは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で使うアセットIDを取得する
  • POST/v1/jobsジョブを送信・Idempotency-Keyが必須
  • GET/v1/jobs自分のジョブを新しい順に、1ページ最大100件
  • GET/v1/jobs/{id}ジョブの状態
  • GET/v1/jobs/{id}/assets/{index}約1時間有効な非公開リンクから出力をダウンロード

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ダウンロードリンク
  • ほかに13種類のツールがMCPサーバーにあります
AIエージェントを設定する

認証

キー1つで、アカウントをまるごと

APIキーはBearerトークンとして送信します。キーはアカウントそのものとして扱われ、クレジットもランクも同じです。キーの有効期間は最長366日で、作成と無効化は「API keys」（APIキー）で行います。同時に持てるキーは最大10個です。

HTTPヘッダー
# すべてのリクエストに付ける
Authorization: Bearer der_user_…

クイックスタート

3ステップで最初のジョブを実行

  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}をポーリングします。同じキーをもう一度送ると、同じジョブが返されます。

    ターミナル
    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}を呼ぶと、約1時間有効な非公開リンクに転送されます。公開リンクはなく、MCPツールが返すのも同じ種類のリンクです。生成結果とアップロードしたファイルは7日間保存され、その後自動的に削除されます。

  • 一覧はページ単位

    GET /v1/jobsは、新しい順に最大100件のジョブを返します。それより古いものは、next_beforeの値をbeforeに渡して取得します。モデル、出力の種類、状態で絞り込むこともできます。

  • 料金

    一部のモデルはカタログに固定の料金があり、それ以外は送信時に料金が決まります。POST /v1/quotesを使うと、先に料金を確認できます。

  • ランク

    一部のモデルには、ProまたはMaxランクのアカウントが必要です。それより低いランクからリクエストすると、403が返されます。

  • クレジットは共通

    APIはスタジオと同じクレジットを消費します。失敗した場合、クレジットは自動で返還されます。

  • モデルに合わせた間隔でポーリング

    カタログには、モデルごとのpoll_secondsがあります。リクエストが多すぎると、Retry-Afterヘッダー付きの429が返されます。

AIエージェント向け

Claude Code・Cursor・CodexからDERを使う

コマンド1つで接続できます。モデルもクレジットも同じで、生成結果はスタジオにも表示されます。

AIエージェントガイドを開く