Seedream 5.5 API
ByteDance の Seedream 5.5 モデルの完全な API リファレンスです。
モデルの種類
この API は次の 2 種類のモデルに対応しています。
比較表
対応するアスペクト比
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9
Seedream 5.5（テキストから画像を生成）
エンドポイント {#}
POST /api/v1/image/task
リクエストパラメータ
必須項目
注意: 幅と高さの比率は次のいずれかにしてください。 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9
任意項目
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'seedream-v5.5',
prompt: 'Editorial fashion portrait, soft window light, muted palette',
resolution: '1.5k',
width: 16,
height: 9,
background: 'auto'
})
});
const { data } = await response.json();
const taskId = data.task_id;
Seedream 5.5 Edit（画像編集）
エンドポイント
POST /api/v1/image/task
リクエストパラメータ
必須項目
注意: 幅と高さの比率は次のいずれかにしてください。 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9
任意項目
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'seedream-v5.5-edit',
prompt: 'Change the hairstyle',
image_url_list: [
'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
],
resolution: '1.5k',
width: 16,
height: 9,
background: 'auto'
})
});
const { data } = await response.json();
const taskId = data.task_id;
画像 1 枚の編集例
{
model_name: 'seedream-v5.5-edit',
image_url_list: ['https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'],
prompt: 'Change the hairstyle',
resolution: '1.5k',
width: 16,
height: 9,
background: 'auto'
}
複数画像の編集例
{
model_name: 'seedream-v5.5-edit',
image_url_list: [
'https://example.com/image1.jpg',
'https://example.com/image2.jpg'
],
prompt: 'Blend these images into a cohesive composition',
resolution: '1.5k',
width: 16,
height: 9,
background: 'auto'
}
レスポンス形式
初回のレスポンス
{
"code": 0,
"message": "success",
"data": {
"task_id": "0ca5f379-327b-4d49-ba19-e38782ceb2f0",
"response_url": "https://api.flaq.ai/api/v1/image/0ca5f379-327b-4d49-ba19-e38782ceb2f0",
"task_status": "submitted"
}
}
ポーリング時のレスポンス
GET /api/v1/image/{task_id} を定期的に呼び出してステータスを確認します。
{
"code": 0,
"data": {
"task_id": "{task_id}",
"task_status": "succeed",
"task_status_msg": null,
"response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
"task_result": {
"credit": 200,
"images": [
{
"url": "https://example.com/generated-image.png"
}
]
}
},
"message": "success"
}
エラーレスポンス
{
"code": 1201,
"message": "[width, height] Invalid parameter (e.g. wrong key or value)",
"data": null
}
ステータス値
submitted: タスクを受け付けましたprocessing: 画像を生成中succeed: 画像の生成が完了しましたfailed: 画像の生成に失敗しました
処理時間
タスクのステータスが succeed または failed になるまでポーリングを続けます。送信済みまたは処理中のタスクでは、レスポンスにまだ画像が含まれていない場合があります。
ベストプラクティス
- 具体的なプロンプト：詳しく描写すると、より良い結果が得られます
- アスペクト比：生成前に用途に合った比率を選びます
- 画像編集の品質：編集には、解像度が高く、十分な光量で撮影された元画像を使用します