Seedream 4.0 图片 API

支持 1K、2K 与 4K 的图片生成和编辑。

提供方

ByteDance

模型 ID

seedream-4.0

请求端点

POST /api-platform/v1/generations

打开模型 Playground 创建 API Key

模型说明

下方价格来自 2026-08-10 核对的后端 apiPlatform 价格树。

请求参数

参数	类型	必填	说明
`model`	string	是	稳定的 PixMind 模型 ID，请使用 `seedream-4.0`。可选值: `seedream-4.0`
`prompt`	string	是	用于生成或编辑的自然语言指令。
`resolution`	string	否	输出分辨率档位，该字段会影响请求价格。可选值: `1K`, `2K`, `4K` 默认值: `1K`
`aspectRatio`	string	否	期望输出画面比例。可选值: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:6`, `6:5`, `2:1` 默认值: `1:1`
`referenceImages`	string[] (URI)	否	用于编辑、构图、主体或风格引导的参考图片 URL 数组。
`n`	integer	否	本次请求生成的图片数量。可选值: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10` 默认值: `1`

请求示例

cURL

curl https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-4.0",
  "prompt": "Create a polished campaign image while preserving the supplied subject",
  "resolution": "1K",
  "aspectRatio": "1:1",
  "referenceImages": [
    "https://example.com/reference.png"
  ]
}'

JavaScript

const response = await fetch("https://aihub-admin.aimix.pro/api-platform/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "seedream-4.0",
  "prompt": "Create a polished campaign image while preserving the supplied subject",
  "resolution": "1K",
  "aspectRatio": "1:1",
  "referenceImages": [
    "https://example.com/reference.png"
  ]
})
});

const task = await response.json();

任务受理响应

生成任务为异步处理。请保存 taskId，并轮询 GET /api-platform/v1/tasks/{taskId}，直到状态为 ready 或 failed。

200 OK

{
  "code": 1000,
  "data": {
    "id": "img_44160",
    "taskId": 44160,
    "type": "image",
    "model": "seedream-4.0",
    "status": "processing"
  }
}

API 定价

配置	价格
1K 输出	$0.040 / image
2K 输出	$0.060 / image
4K 输出	$0.070 / image

API 使用 apiPlatform 角色独立计费，与 PixMind Studio 积分分开；任务受理响应中的价格快照是最终计费依据。