アシスタントに接続
https://seedream-5.io/api/mcpAI ツールの起動環境で SEEDREAM_API_KEY を設定し、下の設定をコピーしてください。ローカル検証時は URL を変更してください。
[mcp_servers.seedream]
url = "https://seedream-5.io/api/mcp"
bearer_token_env_var = "SEEDREAM_API_KEY"Streamable HTTP · Bearer検証状況とクライアントの資料
Codex：画像生成・URL 編集・結果取得を確認済み。Cursor / Grok Build：接続とツール検出を確認済み。Claude Code：接続確認済み。後者 3 つの全操作は未検証です。
追加モデルは本番での画像生成、URL 編集、Codex のネイティブ MCP ツール呼び出しを検証済みです。各クライアントの AI 駆動の全操作は引き続き検証が必要です。
画像プレイグラウンド
モデルと設定を選び、接続済みの AI に引数をコピーしてください。接続設定は共通です。
空でない文字列、最大 3000 文字。画像や変更内容を記述します。
入力パラメーター
| パラメーター | 必須 / 任意 | 型・選択肢・制限 |
|---|---|---|
model | 任意 | stringseedream-5-proモデル ID。省略時は Seedream 5 Pro。 既定値：seedream-5-pro |
request_id | 必須 | string英数字・_・- の 8～128 文字。新しい画像ごとに新しい ID、同じタスクの再試行では同じ ID を使います。 |
prompt | 必須 | string空でない文字列、最大 3000 文字。画像や変更内容を記述します。 |
aspect_ratio | 任意 | string1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9出力画像の比率です。参照画像の比率を保つ場合は同じ比率を指定。auto は Nano Banana 2 のみ。 既定値：1:1 |
resolution | 任意 | string1K · 2K解像度の段階。実際のピクセル寸法は比率によって変わります。 既定値：1K |
output_format | 任意 | stringjpeg · png小文字の jpeg または png。 既定値：jpeg |
image_urls | 画像編集のみ必須 | string[]公開 HTTPS ドメイン画像 URL の配列、1～10 件、各 4096 文字まで。ポートは既定または 443。IP アドレス、ローカルパス、base64、ログイン必須 URL は不可。テキスト生成では省略。 |
記載されたパラメーターのみ対応。無効な値は送信やクレジット予約前に拒否。1 回に 1 枚生成。
照会ツール
seedream_get_model_info- model は任意。{} で全モデルと Pro の既定オプションを取得。
seedream_get_balance- 引数なし：{}。クレジットとキーの残り上限を取得。
seedream_get_task- task_id は必須。作成時に返された UUID を指定。
動画プレイグラウンド
同じ接続先とキーを使います。Standard / Pro とモードを選び、引数を接続済みの AI にコピーしてください。この例ではタスクを送信しません。
参照素材と制限
テキストは prompt 必須。フレームモードは first_frame_url / last_frame_url の少なくとも1つ、参照モードは参照 URL 配列が必須です。フレームと参照は併用不可。素材モードの prompt は任意です。
公開 HTTPS URL のみ。ローカルファイル・base64・ログイン URL は不可。画像は最大10枚、JPEG/PNG/BMP/WebP、各20 MiB以下、辺240–8000 px、比率8以下。動画は最大5本MP4/MOV、各100 MiB以下、辺240–4096 px、比率8以下。音声は最大5本WAV/MP3、各15 MiB以下。動画・音声は各1–15秒、種類ごとの合計15秒以下。参照動画＋出力は30秒以下。URLは完了まで公開し、実ファイルは生成サービスが検証します。
既定：Standard、テキスト、720P（Pro：1080P）、adaptive、5秒、音声あり。MP4固定。寸法は比率に依存します。
入力パラメーター
| パラメーター | 必須 / 任意 | 型・選択肢・制限 |
|---|---|---|
request_id | 必須 | string · 8–128 · A–Z a–z 0–9 _ - |
model | 任意 | wan-3.0-standard | wan-3.0-prime | wan-3.0-pro | wan-3.0-prime-pro既定値：wan-3.0-standard |
mode | 任意 | text-to-video | keyframe-to-video | reference-to-video既定値：text-to-video |
prompt | 必須 | string · 1–20000 |
aspect_ratio | 任意 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | adaptive既定値：adaptive |
resolution | 任意 | 既定値：… |
duration | 任意 | integer · 2–30 s既定値：5 |
audio | 任意 | boolean · true | false既定値：true |
seed | 任意 | integer · 0–2147483647 |
first_frame_url / last_frame_url | 必須 · 開始・終了フレーム | string · HTTPS · ≤4096 |
reference_image_urls | 任意 · 参照素材 | string[] · 1–10 · HTTPS · ≤4096 / URL |
reference_video_urls | 参照素材 | string[] · 1–5 · HTTPS · ≤4096 / URL |
reference_audio_urls | 参照素材 | string[] · 1–5 · HTTPS · ≤4096 / URL |
reference_video_durations / reference_audio_durations | 任意 | number[] · 1–15 s / item · total ≤15 s |
1回にMP4を1本。output_format やプロバイダー・安全設定は不可。無効な引数は予約前に拒否。到達不能や規格外素材は失敗します。任意の参照時間配列はURLの数・順序と一致させ、実ファイルの検証は省略できません。
API キー
AI ツールごとにキーと利用上限を設定します。 呼び出し例とパラメーター