百炼图片 · 千问图像
百炼图片 · 千问图像(qwen-image 系列)
适用 modelKey:qwen-image、qwen-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.aspectRatio | 如 1:1、16:9 |
imageParams.resolution | 如 2k |
imageParams.extraParamsJson | 平台已支持的千问特有字段(JSON 字符串) |
完整字段见 平台异步任务 API(图片) 与 异步任务。
平台字段映射
extraParamsJson 必须是 JSON 字符串;当前平台会解析为对象后按模型能力映射:
| 字段 | 映射说明 |
|---|---|
imageParams.prompt | 映射为千问图像上游消息文本 |
imageParams.resolution + aspectRatio | 映射为上游 parameters.size |
extraParamsJson.negative_prompt、n、prompt_extend、watermark、seed | 映射到上游同名参数 |
imageParams.refImages | 当前 qwen-image / qwen-image-plus 文生图路径不消费;图像编辑请以控制台已上架的编辑 modelKey 和厂商编辑文档为准 |
如控制台开通的是千问图像编辑类 modelKey,通常需要提供 imageParams.refImages;具体以控制台模型详情和厂商编辑文档为准。
平台出参
查单 status=completed 时从 resultUrlPublic 取图片 URL;Webhook 见 Webhook 回调。
原生接口兼容 / 厂商原生
新项目优先使用平台异步任务 API。迁移已有百炼原生代码时,请同时核对:
- JELLYTOKEN 供应商原生接口兼容 的白名单路径
- 下方千问官方文档中的最新请求体结构
model 字段填 JELLYTOKEN modelKey(如 qwen-image-plus)。
厂商全量参数
- 千问文生图 API — 千问文生图
- 千问图像编辑 API — 图像编辑
- 千问图像编辑指南