立即注册

火山方舟图片 · 平台异步任务

火山方舟图片 · 平台异步任务 API（推荐）

适用 modelKey：Seedream 4.0 / 4.5 / 5.0 系列（见 modelKey 速查表）。

示例

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": "一只柴犬，Studio 光，干净背景",
      "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 回调。

平台入参

字段必填说明
modelKey是如 doubao-seedream-5.0
callbackId建议幂等 ID
callbackUrl否Webhook 地址
requestContext否透传键值
imageParams.prompt建议提示词
imageParams.resolution否方舟 size 参数，如 2k、4k 或 1024x1024
imageParams.refImages否参考图 URL 数组
imageParams.extraParamsJson否平台已支持的厂商扩展字段（JSON 字符串）

完整说明见 异步任务（图像/视频/文本）。
Seedream 特有说明见 Seedream 系列。

平台出参

提交响应：taskId、status: queued。

查单 GET /api/ai/tasks/{taskId}：

字段说明
statuspending / running / completed / failed / cancelled
progress执行进度 0–100
resultUrlPublic完成后的图片 URL（优先使用）
error / errorCode失败原因

Webhook 字段见 Webhook 回调。

厂商全量参数

Seedream 侧尺寸、风格、多图参考等完整字段以火山方舟官方文档为准；平台已支持的扩展键可通过 imageParams.extraParamsJson 传递：