APIMart MCP
公式1つのAPIKeyで世界中のすべてのモデルを利用可能
APIMart MCPで何ができますか?
- 利用可能なモデルの確認 — アシスタントに、APIMartで利用可能な画像・動画モデルを名前とバージョン付きで一覧表示してもらいます。
- モデルパラメータの理解 — アシスタントにモデルのドキュメントを読ませ、入力パラメータ、利用制限、呼び出し規約を説明してもらいます。
- 画像の生成 — アシスタントに適切なモデルを選択させ、パラメータを準備し、画像生成タスクを送信して、結果ファイルを返してもらいます。
- 動画の生成 — アシスタントに動画生成タスクを送信させ、その進捗と最終ステータスを監視してもらいます。
- APIキーの安全な設定 — アシスタントに、APIMart APIキーを環境変数として設定する手順を案内してもらい、コマンドやチャットで露出しないようにします。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.apimart.ai/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
agent — APIMart task 模拟演示
「製品のメインビジュアルに適したモデルを見つけて、香水の広告画像を生成し、タスク結果を教えてください。」
- 01 要件の理解 画像生成タスクを識別する
- 02 モデルの選択 能力とパラメータを比較する
- 03 タスクの送信 APIMart API を呼び出す
- 04 結果の取得 ステータスとファイルを取得する
タスク完了のイメージ
Agent はモデルドキュメントに従ってパラメータを準備し、タスクを送信して結果を取得します。ここではフローのみを示しており、リクエストは送信せず、クォータも消費しません。 その他の会話例を見る
APIMart MCP の list_models を使用して、利用可能なモデルを 5 つ一覧表示します。コンテンツは生成しないでください。
→ APIMart / list_models
{"limit": 5}
模型展示名称(示例,非 API 模型 ID):
01 GPT Image 2.5
02 Nano Banana Pro
03 Seedream 5.0 Pro
04 Z-Image Turbo
05 Midjourney
✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。
3つの方法、用途に応じて接続
使用習慣に合わせて、ドキュメント、リモートツール、ローカルスキルから選択できます。具体的にサポートされる操作は、対応するインターフェース、ツール、クライアントによって異なります。
ステップに沿って接続を完了する
1つの方法を選択し、ステップに沿って設定を完了します。コマンドはそのままコピーでき、テスト用のプロンプトも用意されています。
APIMart Agent Tools
macOS · zsh · Codex デスクトップ版 · 本番環境
API Key の安全な設定
本番環境で利用可能
まず APIMart で有効な API Key を作成し、macOS の zsh ターミナルで以下のコマンドを実行します。プロンプトに従って Key を非表示で入力します。
ターミナルコマンド
read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY
実際の Key はターミナルのプロンプトで入力するときだけ貼り付けてください。コマンド、チャット、スクリーンショットに書き込まないでください。漏洩した Key は無効化して再作成してください。
詳細と適用範囲
この設定は、現在のログインセッションで再起動するデスクトップアプリに適用されます。設定後、Codex デスクトップ版を完全に終了してから再度開いてください。ターミナル版を使用する場合は、Key を非表示で入力した後、export APIMART_API_KEY を実行し、同じターミナルから Codex を起動してください。ここでの unset は実行しないでください。以下はキー形式のイメージのみを示しており、実行や置換は不要です。
キー形式のイメージ・実行不要 sk-••••••••••••••••
選び方は、あなたの使用習慣次第
ドキュメントを素早く確認したい場合は AI ドキュメント、日常的なツール呼び出しには MCP、ローカルスクリプトと固定フローが必要な場合は Skill を選択してください。
| 接続方法 | 最適な用途 | インストールと設定 | 能力の実行場所 | 主な利点 | 注意点 | クイックスタート |
|---|---|---|---|---|---|---|
| AI ドキュメント llms.txt | 一時的な問い合わせ、呼び出しコードの生成 | インストール不要、プロンプトをコピー | Agent がドキュメントを読み、コードを実行 | 軽量で手軽、柔軟に API を呼び出せる | ウェブ読み取り機能が必要、コード実行には認証情報が必要 | 接続手順を見る |
| MCP 推奨 | 高頻度の対話、日常的な作成 | リモートサービスと Key を設定 | APIMart リモート MCP | 構造化されたツール、ローカル MCP パッケージ不要 | ネットワークとクライアントのサポートに依存、提供されたツールのみに限定 | 接続手順を見る |
| Agent Skill ローカルスキルパック | 固定フロー、チーム標準化 | GitHub 経由で完全なディレクトリをインストール | ローカルスクリプトが APIMart API を呼び出す | フローを再利用可能、MCP から独立 | Node.js が必要、更新時に再インストールが必要な場合あり | 接続手順を見る |
Agent でできること
モデル発見、ドキュメント理解、一般的な画像・動画タスクを中心に展開します。使用前に、選択したモデル、ツール、ローカルクライアントが対応する操作をサポートしているか確認してください。
モデル発見
タスクの目標に応じて利用可能なモデルを探し、現在のニーズに適した能力とバージョンを確認します。
パラメータとドキュメント
入力パラメータ、使用説明、制限事項を読み、モデルの呼び出し方法を理解します。
画像生成
モデル選択、パラメータ準備、タスク送信、ステータス確認、結果取得を完了します。
動画生成
動画モデルを呼び出し、タスクの進捗、実行ステータス、最終結果を継続的に取得します。
API Key はインストールコマンドに含まれません
環境変数を通じて認証情報を渡すことで、Key がターミナル履歴、スクリーンショット、チャットログに誤って保存されるリスクを減らします。
- ドキュメントを読んでから、認証情報を設定する AI ドキュメントは Agent がインターフェースを理解するのに役立ちますが、自動的にモデル呼び出しを開始することはありません。
- 環境変数から読み取る MCP と Skill は環境変数から Key を読み取ります。Key をプロンプトやインストールコマンドに書き込まないでください。
- モデルを問い合わせて接続を検証する 実際の生成は APIMart アカウントのルールに従って課金されます。接続後は、まずモデルを問い合わせて設定を検証してください。
よくある質問
1つの方法を選んで、使い始める
MCP と Skill はそれぞれ独立して利用できます。AI ドキュメントはインストール不要で、プロンプトをそのままコピーできます。