CMO AI Pro Developers
バナー制作ツール
バナー生成の開始と結果取得を行う2つのツールの仕様です。
最終更新日：2026年8月26日
バナー生成の開始と、結果の取得に使う2つのツールです。
バナーの判定確定と公開はMCPから実行できません。 生成された候補を比較して採否を決める操作は、 CMO AI Proの画面で人が行います。エージェントができるのは、生成の開始と結果の取得までです。
start_banner_generation
バナー生成ジョブを開始します。完了は待ちません。指定した戦略仮説とテンプレートの組み合わせで 生成します。
生成に使えるのは、AI解析が完了した（status が templated の）テンプレートだけです。 テンプレートの状態は list_templates で確認できます。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
strategy_id | 文字列 | 必須 | — | UUID。案件に属していること |
template_ids | 文字列の配列 | 任意 | 空配列 | 0〜5件。省略時は参考テンプレートなしで生成。UUID |
count | 整数 | 任意 | 1 | 1〜5。テンプレート1件あたりの生成数 |
size_preset_id | 文字列 | 任意 | — | 1〜100文字。基本5サイズから指定 |
additional_instruction | 文字列 | 任意 | 空文字 | 2,000文字以内 |
generation_batch_id | 文字列 | 任意 | — | UUID。指定不要（冪等キーから決まります） |
selected_reference_image_ids | 文字列の配列 | 任意 | 空配列 | 16件以内（テンプレート指定時は15件以内）。UUID |
idempotency_key | 文字列 | 必須 | — | 1〜128文字 |
generation_batch_id は互換性のために残っているパラメータです。実際のバッチIDは idempotency_key から決定されるため、指定しても使われません。
応答
| フィールド | 内容 |
|---|---|
jobId | ジョブID |
workflowRunId | 生成処理の実行ID |
status | queued |
generationBatchId | このバッチのID |
reused | すでに同じバッチのジョブがある場合に true（新規消費なし） |
エラー
| code | 発生条件 |
|---|---|
not_found | 案件・戦略仮説・テンプレートが存在しない、または組織外 |
validation_error | サイズが基本5サイズ外、追加指示が2,000文字超、テンプレート未解析、商品マスター未登録、参考画像の形式・枚数違反 |
conflict | 利用を終了したテンプレートを指定した、同じ対象の処理が実行中 |
payment_required | クレジット不足、または日次上限 |
消費
1案あたり60クレジットです。消費量は「max(template_ids件数, 1) × count」で決まります。 たとえばテンプレート2件 × 3案なら6案となり、360クレジットです。
生成を始める前に get_credit_balance で残高を確認することを推奨します。
get_banner_results
案件のバナー生成結果を、作成日時の新しい順で取得します。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
limit | 整数 | 任意 | 20 | 1〜50 |
応答
| フィールド | 内容 |
|---|---|
banners[].id | バナーID |
banners[].status | queued / prompting / generating / succeeded / failed |
banners[].errorMessage | 失敗時のメッセージ |
banners[].size | 画像サイズ |
banners[].strategyId | 使用した戦略仮説ID |
banners[].templateId | 使用したテンプレートID。テンプレートなしの場合は null |
banners[].isReviewSelected | 画面上で選択されているか |
banners[].createdAt | 作成日時 |
banners[].signedUrl | 表示用の署名付きURL（1時間有効） |
banners[].downloadUrl | ダウンロード用の署名付きURL（1時間有効） |
長時間更新がない生成中のバナーは、failed として返ります。
署名URLの取り扱い
signedUrl と downloadUrl は1時間有効です。URLを知る第三者は有効期間内に画像へアクセス できます。会話ログ、実行ログ、チケット、画面共有へ転載しないでください。詳しくは セキュリティを参照してください。
生成後の流れ
get_job_statusでジョブの完了を確認するget_banner_resultsで結果を取得する- CMO AI Proの画面で候補を比較し、判定を確定して公開する
3の操作はMCPからは実行できません。