百炼图片 · 千问图像

百炼图片 · 千问图像(qwen-image 系列)

适用 modelKeyqwen-imageqwen-image-plus


推荐接入

使用 平台异步任务 API(图片)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": "qwen-image-plus",
    "callbackId": "qwen-img-001",
    "imageParams": {
      "prompt": "一只可爱的机器人,产品渲染风格,干净背景",
      "aspectRatio": "1:1",
      "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 回调。需安装 jq 解析 taskId

平台入参

字段说明
imageParams.prompt文生图提示词
imageParams.aspectRatio1:116:9
imageParams.resolution2k
imageParams.extraParamsJson平台已支持的千问特有字段(JSON 字符串)

完整字段见 平台异步任务 API(图片)异步任务

平台字段映射

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

字段映射说明
imageParams.prompt映射为千问图像上游消息文本
imageParams.resolution + aspectRatio映射为上游 parameters.size
extraParamsJson.negative_promptnprompt_extendwatermarkseed映射到上游同名参数
imageParams.refImages当前 qwen-image / qwen-image-plus 文生图路径不消费;图像编辑请以控制台已上架的编辑 modelKey 和厂商编辑文档为准

如控制台开通的是千问图像编辑类 modelKey,通常需要提供 imageParams.refImages;具体以控制台模型详情和厂商编辑文档为准。

平台出参

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

原生接口兼容 / 厂商原生

新项目优先使用平台异步任务 API。迁移已有百炼原生代码时,请同时核对:

model 字段填 JELLYTOKEN modelKey(如 qwen-image-plus)。

厂商全量参数

原生接口兼容说明

供应商原生接口兼容 · 百炼原生接口兼容(图片)