1. 概述
使用当前 API Key 已开通的万相图片生成模型生成图片。
baseUrl:https://token.soar.qjclouds.cn/laserEr/00000000/v1completionsPath:/image/generations/{apiType}apiType:TextToImage- 标准地址:
POST {baseUrl}{completionsPath} - 鉴权:
Authorization: Bearer <api_key>
请求地址:https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/TextToImage
2. 鉴权
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <api_key> |
Content-Type | 是 | application/json |
3. 请求体
请求体采用阿里云原厂 API JSON 格式。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 实际开通的万相图片生成模型为准。 |
input | object | 是 | 模型输入信息。 |
input.messages | array<object> | 是 | 消息列表;仅支持单轮对话,必须且只能包含一个消息对象。 |
input.messages[].role | string | 是 | 消息角色,固定为 user。 |
input.messages[].content | array<object> | 是 | 消息内容列表。 |
input.messages[].content[].text | string | 是 | 正向提示词,描述期望的图片主体、场景、风格和构图。 |
parameters | object | 否 | 图片生成参数。 |
parameters.negative_prompt | string | 否 | 反向提示词,描述不希望出现的内容;支持中英文,最长 500 个字符,超出部分自动截断。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写;默认 true,仅优化正向提示词。 |
parameters.watermark | boolean | 否 | 是否在图片右下角添加水印;默认 false。 |
parameters.size | string | 否 | 输出分辨率,格式为 宽*高;具体范围由所选模型决定。 |
parameters.n | integer | 否 | 生成图片数量,默认 1;具体上限由所选模型决定。 |
parameters.seed | integer | 否 | 随机数种子,范围 0–2147483647;相同种子可提高结果稳定性,但不保证完全一致。 |
4. 请求示例
JSON
{
"model": "wan2.6-t2i-cn",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵"
}
]
}
]
},
"parameters": {
"prompt_extend": true,
"watermark": false,
"n": 1,
"negative_prompt": "",
"size": "1280*1280"
}
}5. 响应示例
JSON
{
"output": {
"choices": [
{
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/11/20260910/b2c23dbd/99018118-99bXG1G4_fc92db2a46f8.png?Expires=1789119040&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=tEaXmc9KukNwRyUbR4yR2ZNqGBI%3D",
"type": "image"
}
]
},
"finish_reason": "stop"
}
],
"finished": true
},
"usage": {
"size": "1280*1280",
"image_count": 1,
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0
},
"request_id": "6a1a1058-56c4-4e1f-93ea-9425efe102ae"
}响应图片 URL 通常具有有效期,请及时下载或转存。