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では、同じアドレスと同じヘッダーでカスタムコネクタを追加してください。

公開されているツールは4つです。list_modelsはカタログとクレジット単位の価格を返します。generate_imageは画像を作成して結果を待ち、URLを直接返します。generate_videoは動画の生成を開始して追跡用のIDを返します。get_generation_statusは生成を最終URLまで追跡します。

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分かかります。正確なコストは、結果が出る前の開始時点で返されます。

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