Seedream 图片 API

使用官方分组 API Key。以下模型 ID 是本站公开调用 ID，请原样填写。

支持的协议

使用 JSON POST /v1/images/generations 生成图片，使用 POST /v1/images/edits（multipart/form-data）上传文件编辑。提交返回 202 Accepted 和任务 id，之后轮询 GET /v1/tasks/{id}，直到 completed 或 failed。202 不表示已经出图。

本系列使用 Images + 异步任务，不支持通过 /v1/chat/completions 或 /v1/responses 生成图片。完整示例见提交并轮询。

模型与参数

4.0、4.5 无参考图时仅支持 n=1；4.0、4.5、Lite 的参考图数量加输出数量不得超过 15。Lite 支持无参考图批量生成。Pro 固定单张。size 通常填 1:1、16:9 等宽高比；auto 必须提供参考图。Pro 也支持有效的 WIDTHxHEIGHT 精确像素尺寸。

生成图片

先将 APIPOOL_API_KEY 设置为自己的 Key，再运行示例：

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/images/generations" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A blue ceramic cup on a white table",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
}'

编辑图片

上传本地 PNG、JPEG 或 WebP 文件；把 source.png 换成实际文件路径：

curl "https://app.apipool.dev/v1/images/edits" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -F "model=seedream-5-0-pro" \
  -F "prompt=Change the cup to green" \
  -F "image=@./source.png" \
  -F "size=1:1" \
  -F "resolution=1K" \
  -F "n=1"

多张参考图可重复 -F "image=@./second.png"，不得超过模型上限。 已有可公开下载的参考图时，也可在同一个 JSON 生成接口中传 image_urls：

{
  "model": "seedream-5-0-pro",
  "prompt": "Change the cup to green",
  "size": "1:1",
  "resolution": "1K",
  "n": 1,
  "image_urls": ["https://your-cdn.example/source.png"]
}

把示例 URL 换成服务端可访问的真实地址。临时隧道失效、DNS 解析失败或下载超时 会导致任务失败；不要使用仅自己的浏览器可访问的本机或登录态地址。

查询与获取结果

保存提交响应中的 id（例如 imgtask_01...），使用提交时同一个 Key 查询：

TASK_ID="imgtask_01..."
curl "https://app.apipool.dev/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIPOOL_API_KEY"

submitted、submission_unknown、processing、meter_pending 时继续查询； completed 时读取 data[].url 并在有效期内下载；failed 时读取 error。 不要因为尚未完成就重复提交。完整状态、超时处理和可运行轮询示例见 图片异步任务。

范围与计费

不要传 stream: true、tools、蒙版或显式连续生成参数。暂不支持 layer_decomposition: true。

以模型与价格为准。Pro 第 1 张参考图不附加费用，第 2 张起逐张计费；批量生成按模型对应档位与实际成功交付数量结算。