立即注册

火山方舟图片 · Seedream

方舟图片 · Seedream 系列

适用 modelKey：

modelKey代际
doubao-seedream-5.05.0
doubao-seedream-4.54.5
doubao-seedream-4.04.0

命名说明：上表为 JELLYTOKEN modelKey（小写），可能不同于火山方舟官方 Model ID（如 doubao-seedream-4-5-251128）；调用时以 GET /v1/models 返回为准。

推荐接入

平台异步任务 API（图片）

示例（文生图）

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "doubao-seedream-5.0",
    "callbackId": "seedream-001",
    "imageParams": {
      "prompt": "a cute robot mascot, product render, clean background",
      "resolution": "2k"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status=completed 时从 resultUrlPublic 取图片地址。建议每 2~5 秒轮询，或使用 Webhook 回调。

平台入参

字段说明
imageParams.prompt提示词
imageParams.resolution方舟 size 参数，如 2k、4k 或 1024x1024
imageParams.refImages参考图（若模型支持）
imageParams.extraParamsJson平台已支持的 Seedream 特有字段

完整字段见 平台异步任务 API（图片）。

平台字段映射

extraParamsJson 必须是 JSON 字符串；当前平台会解析为对象后按模型能力映射：

字段映射说明默认值 / 约束
imageParams.prompt映射到方舟 prompt必填
imageParams.refImages映射到方舟 image；单张为字符串，多张为数组可选
imageParams.resolution映射到方舟 size支持 2k / 4k / 1024x1024 等格式
imageParams.aspectRatio当前不单独映射如需固定画幅，使用像素尺寸作为 resolution
extraParamsJson.watermark映射到方舟同名字段默认 false
extraParamsJson.seed映射到方舟同名字段可选
extraParamsJson.response_formaturl 或 b64_json默认 url
extraParamsJson.guidance_scale映射到方舟同名字段仅 Seedream 5.0 生效；4.x 系列不映射
extraParamsJson.sequential_image_generation 等组图模式、流式等仅 Seedream 4 系列时映射

Seedream 底层使用方舟图片生成接口；JELLYTOKEN 仍统一封装为平台任务接口，调用方按 taskId 查询结果即可。

平台出参

查单 status=completed 时从 resultUrlPublic 取图片 URL；Webhook 见 Webhook 回调。

厂商全量参数

文档说明
图片生成 API图片生成 HTTP API
Seedream 4.0/5.0 教程使用教程
Seedream 提示词指南提示词
图片生成模型说明模型说明

原生接口兼容

POST /ark/api/v3/images/generations

见 火山方舟原生接口兼容（图片）