APIとMCPサーバー

APIキーでClaude、Cursor、自作スクリプトから生成。モデルもクレジットも同じで、失敗は返金されます。

キャンバスの外のImaginode

キャンバスで生成できるものはすべて、その外からも利用できます。REST APIとMCPサーバー(Model Context Protocol)により、AIエージェントやスクリプトがあなたのアカウントで画像や動画を作成できます。呼び出しは残高のクレジットを消費し、価格はキャンバスと同じです。失敗した生成はいつもどおり自動的に返金されます。

MCPは、AIアシスタント(Claude、Cursorほか多数)が外部ツールを使うための標準規格です。Imaginodeを接続すれば、アシスタントは会話の途中で画像を生成したり、執筆中の記事に図版を添えたり、自動化されたワークフローのビジュアルを作ったりできます。

APIキーを作成する

プロフィールの「APIキー」セクションを開きます。キーに名前を付けて(「Claude Code」「ブログ用スクリプト」など)作成しましょう。imk_…のシークレットは一度しか表示されないので、すぐにコピーしてください。有効なキーは最大5個で、いつでもワンクリックで失効できます。失効したキーは即座に使えなくなります。

作成にはメールアドレスの確認が必要で、各キーは1分あたり10生成に制限されています。快適に作業するには十分な量ですが、エージェントが暴走しても残高をうっかり使い切ることはありません。

MCPサーバーを接続する

サーバーのアドレスはhttps://imaginode.ai/api/mcp(Streamable HTTPトランスポート)です。「Authorization: Bearer imk_…」ヘッダーにキーを入れて認証します。Claude Codeならコマンド1つで完了です:claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer あなたのキー"。Claude.aiやCursorでは、同じアドレスと同じヘッダーでカスタムコネクタを追加してください。

14個のツールが公開されています。list_modelsはカタログ、各モデルの機能、クレジット価格を返します。get_balanceは残高を読み取り、生成を開始する前にそのコストがカバーされているかを確認できます。list_templatesとget_templateはキャンバステンプレートを説明します:モデル、プロンプト、配線、例、そして即実行できる状態で開くリンクです。generate_imageは画像を生成し、結果を待ちます:URLが直接返されます。generate_videoは動画の生成を開始します(開始画像、終了画像、参照画像)。トラッキングIDが返されます。generate_speechはカタログの音声、またはクローンした音声のいずれかでテキストやダイアログを読み上げます。generate_soundは効果音や音楽トラックを生成し、enhance_audioは音声のクリーンアップ、分離、抽出を行います。edit_imageは拡大、切り抜き、または写真の3Dオブジェクト化を行い、edit_videoは拡大、切り抜き、延長、音声へのリップシンク、またはモーションの転送を行います。list_voicesとlist_charactersはご自身の音声とキャラクターを読み取り、get_generation_statusは生成を最終的なURLまで追跡します。このサーバーは2026-07-28版のプロトコルに加え、2025年のハンドシェイク版にも対応しています:現在のクライアントも、将来のクライアントも、特別な設定なしに接続できます。

REST APIを直接使う

スクリプトからなら、3つのエンドポイントで足ります。GET /api/modelsは、モデルとそのオプション、価格を認証なしで一覧します。POST /api/generateは生成を開始します。modelとprompt、モデルのオプション(duration、resolution、aspectRatio、audio、imageUrls)を含むJSONを、Authorizationヘッダーにキーを入れて送ると、レスポンスにrequestId、cost、新しい残高が含まれます。GET /api/generate/status?requestId=…はrunningを返し、その後、出力URL付きのcompleted、または返金付きのfailedを返します。

入力画像(imageUrls)は、Imaginodeアカウントにホストされたメディアである必要があります。まずメディアに取り込むか、以前の生成のURLを再利用してください。

ベストプラクティス

まずは経済的なモデル(Flux Schnell、1クレジット)でプロンプトを検証してから、プレミアムモデルに移りましょう。動画は30秒ごとにステータスを確認してください。通常は1〜5分、長い生成では最大30分かかります。正確なコストは、結果が出る前の開始時点で返されます。

キーは秘密情報です。リポジトリにコミットしたり、共有したりしないでください。少しでも不安があれば、プロフィールから失効させて新しいキーを作成しましょう。