立即注册

百炼图片 · 平台异步任务

百炼图片 · 平台异步任务 API（推荐）

适用模型：本目录下全部百炼图片 modelKey（见 modelKey 速查表 与各系列文档）。

端点

POST /api/ai/tasks
GET  /api/ai/tasks/{taskId}

文生图示例

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": "qwen-image-plus",
    "callbackId": "img-001",
    "imageParams": {
      "prompt": "赛博朋克城市夜景，电影感",
      "aspectRatio": "16:9",
      "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": "wan2.6-image",
  "callbackId": "img-002",
  "imageParams": {
    "prompt": "把背景换成海滩",
    "refImages": ["https://example.com/source.jpg"]
  }
}

平台入参

字段必填说明
modelKey是JELLYTOKEN 模型 ID（如 qwen-image-plus、wan2.6-t2i）
callbackId建议幂等 ID；与租户 ID 组合为 taskId
callbackUrl否完成/失败时 POST 回调
requestContext否透传键值，如 user_id
imageParams.prompt建议提示词
imageParams.aspectRatio否如 16:9、1:1
imageParams.resolution否如 2k
imageParams.refImages否参考图 / 源图 URL 数组（编辑、图生图）
imageParams.extraParamsJson否平台已支持的厂商扩展字段（JSON 字符串）

完整说明与文本/视频字段见 异步任务（图像/视频/文本）。
各 modelKey 特有字段见本目录 千问图像、万相图像。

平台出参

提交响应：taskId、status: queued（仅出现在提交响应）。

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

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

Webhook 回调字段见 Webhook 回调。

厂商全量参数

百炼侧尺寸枚举、编辑模式、多图输入等完整字段以官方文档为准；平台已支持的扩展键可通过 imageParams.extraParamsJson 传递，具体对照各系列文档中的厂商链接：