開発者API

プログラムからアニメーション解説を生成

DeepManim APIを使う

DeepManimのAPIで、概念を見える動画に変換できます。

ベースURL https://api.deepmanim.com/api/v1

重要な注意

  • 非同期処理 生成エンドポイントはジョブを返します。完了までジョブの状態を確認してください。
  • ナレーション 生成にはデフォルトで音声ナレーションが含まれます。
  • クレジット 生成と改善にはクレジットが必要です。読み取り系の呼び出しは無料です。

認証

APIキーをAuthorizationヘッダーに含めてください。

クレジットが必要です 生成、改善、音声処理にはクレジットが必要です。

設定からAPIキーを作成し、安全に保管してください。

Authorization: Bearer dm_k_your_api_key_here

キーを秘密にする APIキーをクライアント側のコードや公開リポジトリに含めないでください。

クイックスタート

最初の動画を3ステップで生成します。

APIキーを作成する

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": "ja"}'

generateにリクエストを送る

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

ジョブが完了するまで確認する

# 完了時の応答:
{
  "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": "実生活ではどのように使われますか?"
  }
}

エンドポイント

動画生成

ジョブ

セッション

メッセージ

アカウント

クレジット

操作ごとに必要なクレジットを確認できます。

操作コスト
生成開始コスト
改善開始コスト
音声追加1 クレジット
ナレーション改善1 クレジット

実際のコストは選択したプリセットにより変わります。

エラー

ステータス意味
401APIキーがないか無効です。
402クレジットが不足しています。
404リソースが見つかりません。
400リクエストが無効です。
開発者API | DeepManim