Seedream V5.0 Pro Edit 画像編集・生成 API
doubao/seedream-v5.0-pro/image-to-image
ByteDance の Seedream V5.0 Pro Edit は、単一画像または複数の参照画像をもとに画像の編集・生成を行えます。最大 10 枚の参照画像に対応し、アスペクト比の選択と 1K / 2K の出力階層をサポートしています。すぐに使える REST 推論 API で、高性能、コールドスタートなし、手頃な価格です。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| prompt *プロンプト | textarea | — | ≤ 5000 chars | 生成に使用するポジティブプロンプトです。 |
| images *画像 | image_upload | — | image/* · 1–10 items | 編集する画像です。参照画像は最大 10 枚までアップロードできます。 |
| resolution解像度 | select | 1k | 1k | 2k | 課金に使用される出力解像度の階層です。1k は低コストの階層、2k は高コストの階層です。 |
| aspect_ratioアスペクト比 | select | — | 1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | … | 生成画像のアスペクト比です。空欄の場合、最初の入力画像に基づいて、対応する中で最も近いアスペクト比が自動的に使用されます。 |
| output_format出力形式 | select | jpeg | jpeg | png | 出力画像の形式です。 |
出力フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| images | array<string> |
API
統一 REST API でこのモデルを呼び出せます。API Keys ページでキーを取得してください。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);ドキュメント
Seedream V5.0 Pro Edit API
単一画像または複数参照画像から高品質な編集生成を行える、最大 10 枚の参照画像と 2K 出力に対応したモデルです。
Seedream V5.0 Pro Edit は、ByteDance による高度な画像編集モデルです。1 枚または複数の参照画像をもとに、プロンプトで編集内容を指定でき、優れたプロンプト追従性、柔軟なアスペクト比設定、そしてコールドスタートなしの安定した実行性能を備えています。制作ワークフロー、EC 画像制作、反復的なクリエイティブ開発に適したモデルです。
🚀 主な特長
- 複数参照画像による編集:最大 10 枚の参照画像を利用でき、複雑な構図、人物や商品の一貫性維持、スタイル誘導に対応します。
- 自然言語ベースの編集:変更したい内容と維持したい内容をプロンプトで記述するだけで編集を行えます。
- 高品質な仕上がり:高いプロンプト追従性と安定したビジュアル品質により、完成度の高い画像生成が可能です。
- 柔軟なアスペクト比対応:正方形、縦向き、横向き、ワイドなど幅広いアスペクト比をサポートします。
- 1K / 2K 出力 tier:高速な試行には 1K、最終成果物には 2K を選択でき、コストと品質のバランスを取りやすくなっています。
- コールドスタートなし:リアルタイム用途やバッチ処理でも、より安定した運用体験を提供します。
🛠️ 技術仕様
| 項目 | 内容 |
|---|---|
| モデルアーキテクチャ | 画像編集 / 複数参照画像条件付き画像生成モデル |
| タスク種別 | text-to-image(画像条件付き編集生成) |
| 入力 | プロンプト + 1~10 枚の参照画像 |
| 出力 | 編集済み画像 1 枚 |
| 最大参照画像数 | 10 枚 |
| アスペクト比 | 1:1、1:2、2:1、1:3、3:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、9:21、21:9 |
| アスペクト比の挙動 | 未指定の場合、最初の入力画像に基づいて最も近い対応アスペクト比が自動選択されます |
| 解像度 | 1k、2k |
| 出力形式 | jpeg、png |
| 品質特性 | 複数画像ガイダンスに対応したプロフェッショナル向け画像編集 |
| レイテンシ | コールドスタートなし。実際の推論時間は入力の複雑さと出力 tier により変動します |
サンプルプロンプト
- 被写体の顔立ちは維持したまま、背景をモダンでミニマルなカフェに変更し、自然光のリアルな写真表現にしてください。
- 参照の商品画像を使って、白背景・均一なライティング・高級感のある質感表現を備えた EC 向けメインビジュアルを生成してください。
- 服のデザインと色は維持しつつ、モデルのポーズを横向きの立ち姿に変更し、9:16 のポスター構図に最適化してください。
💰 料金
| 項目 | 価格 |
|---|---|
| 1k 出力 | $0.045 |
| 2k 出力 | $0.090 |
| 追加参照画像コスト | 追加 1 枚ごとに $0.003 |
注:最初の入力画像 1 枚は基本料金に含まれます。
💡 主なユースケース
- EC 画像編集:商品画像の補正、背景差し替え、見た目の統一、販促素材の制作に適しています。
- ブランド・広告クリエイティブ:ブランド参照に沿った高品質なキャンペーンビジュアルを効率的に生成できます。
- キャラクターや人物の一貫性維持:人物のアイデンティティ、衣装、雰囲気、スタイルを複数案にわたって保ちやすくなります。
- SNS コンテンツ制作:各プラットフォーム向けに、異なるアスペクト比のカバー画像、広告素材、投稿用ビジュアルを作成できます。
🔗 関連モデル
- Seedream V5.0 Pro:参照画像を使わないテキストからの画像生成に適しています。
- Seedream V5.0 Lite Edit:コストや速度を重視するワークフロー向けの軽量な画像編集モデルです。
関連モデル
xAI Grok Imagine Image v2.0 画像編集
xAI Grok Imagine Image V2.0 Edit は、テキストによるプロンプトを使って入力画像を編集できるモデルです。解像度と品質を設定でき、精密な画像編集、ビジュアル調整、クリエイティブなバリエーション、SNS コンテンツ、マーケティング素材、制作ワークフローに適しています。すぐに使える REST 推論 API を提供し、高性能・コールドスタートなし・手頃な価格で利用できます。
qwen-image-edit-spicy
テキスト指示で画像を精密に編集。要素の追加・削除・変更、スタイル変換、背景置換に対応し、写真補正やビジュアルデザインに適しています。
Qwen Image 3.0 Pro Edit|高速画像編集
Qwen Image 3.0 Pro Edit は、優れた画質と高度な指示理解を備えたプロ向けの画像編集モデルです。最大 2k に対応。すぐに使える REST inference API を提供し、高性能、コールドスタートなし、手頃な価格で利用できます。
OpenAI GPT Image 2.5 Sunburst 画像編集
最大 16 枚の参照画像を使用し、高精細で正確な画像編集を行います。
OpenAI GPT Image 2.5 Flare 画像編集
自然言語の指示と最大 16 枚の参照画像を使用して、高速でバランスの取れた画像編集を行います。
ヘッドスワップ(画像)
namifusion/head-swap/image-edit. 画像・動画・顔交換のモデル API を閲覧。試してから統一 REST API で統合。
Nano Banana 画像編集
高速・低価格な編集。 マスキング不要で、直感的なオブジェクト置換やスタイル変換が可能。
Nano Banana Pro 画像編集
4K セマンティック編集。自然言語で画像を修正。文脈認識と画像内多言語テキスト編集に対応。