金山云-文档中心-通义wan2.6-t2i

星流平台

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

星流平台

模型API服务

API文档

图片生成模型

通义wan2.6-t2i

最近更新时间：2026-06-30 21:56:57



本文介绍金山云 wan2.6-t2i 文生图模型的 HTTP 调用方式，支持同步和异步两种模式。

HTTP 同步调用

请求信息

请求方法	请求路径
POST	https://kspmas.ksyun.com/v1/services/aigc/multimodal-generation/generation

请求头

字段	类型	是否必填	描述
Content-Type	string	是	请求内容类型。此参数必须设置为 `application/json`。
Authorization	string	是	请求身份认证，接口使用金山云 API Key 进行身份认证。格式为 `Bearer KSC_API_KEY`。`KSC_API_KEY`的创建和使用可参考API Key相关内容。

请求参数

字段	类型	是否必填	描述
model	string	是	模型名称。示例值：`wan2.6-t2i`。
input	object	是	输入的基本信息。
input.messages	array	是	请求内容数组。当前仅支持单轮对话，即传入一组 `role`、`content` 参数，不支持多轮对话。
input.messages[].role	string	是	消息的角色。此参数必须设置为 `user`。
input.messages[].content	array	是	消息内容数组。
input.messages[].content[].text	string	是	正向提示词，用于描述期望生成的图像内容、风格和构图。支持中英文，长度不超过 2100 个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。仅支持传入一个 `text`，不传或传入多个将报错。
parameters	object	选填	图像处理参数。
parameters.negative_prompt	string	选填	反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制。支持中英文，长度不超过 500 个字符，超出部分将自动截断。示例值：`低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。`
parameters.size	string	选填	输出图像的分辨率，格式为 `宽高`。总像素在 [1280×1280, 14401×440] 之间且宽高比范围为 [1:4, 4:1]。例如，`7682700` 符合要求。
parameters.n	integer	选填	生成图片的数量。取值范围为 1~4 张，默认为 4。
parameters.prompt_extend	bool	选填	是否开启 prompt 智能改写。开启后，将使用大模型优化正向提示词，对较短的提示词有明显提升效果，但增加 3~4 秒耗时。默认 `true`，开启智能改写。
parameters.watermark	bool	选填	是否添加水印标识，水印位于图片右下角，文案固定为"AI 生成"。默认 `false`，不添加水印。
parameters.seed	integer	选填	随机数种子，取值范围 [0, 2147483647]。使用相同的 `seed` 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。模型生成过程具有概率性，即使使用相同的 `seed`，也不能保证每次生成结果完全一致。

请求示例

curl --location 'https://kspmas.ksyun.com/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ***" \
--data '{
  "model": "wan2.6-t2i",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "watermark": false,
    "n": 1,
    "negative_prompt": "",
    "size": "1280*1280"
  }
}'

返回参数

字段	类型	描述
output	object	任务输出信息。
output.choices	array	模型生成的输出内容。
output.choices[].finish_reason	string	任务停止原因，自然停止时为 `stop`。
output.choices[].message	object	模型返回的消息。
output.choices[].message.role	string	消息的角色，固定为 `assistant`。
output.choices[].message.content	array	消息内容数组。
output.choices[].message.content[].image	string	生成图像的 URL，图像格式为 PNG。链接有效期为 24 小时，请及时下载并保存图像。
output.choices[].message.content[].type	string	输出的类型，固定为 `image`。
output.finished	boolean	任务是否结束。`true` 表示已结束，`false` 表示未结束。
usage	object	输出信息统计。只对成功的结果计数。
usage.image_count	integer	生成图像的张数。
usage.size	string	生成的图像分辨率。示例值：`1280*1280`。
usage.input_tokens	integer	输入 token。文生图按图片张数计费，当前固定为 0。
usage.output_tokens	integer	输出 token。文生图按图片张数计费，当前固定为 0。
usage.total_tokens	integer	总 token。文生图按图片张数计费，当前固定为 0。
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。

返回示例

任务数据（如任务状态、图像 URL 等）仅保留 24 小时，超时后会被自动清除。请您务必及时保存生成的图像。

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": [
            {
              "image": "https://xxx.com/xxxx.png?Expires=xxx",
              "type": "image"
            }
          ],
          "role": "assistant"
        }
      }
    ],
    "finished": true
  },
  "usage": {
    "image_count": 1,
    "input_tokens": 0,
    "output_tokens": 0,
    "size": "1280*1280",
    "total_tokens": 0
  },
  "request_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxx"
}

HTTP 异步调用

请求信息

请求方法	请求路径
POST	https://kspmas.ksyun.com/v1/services/aigc/multimodal-generation/generation

请求头

字段	类型	是否必填	描述
Content-Type	string	是	请求内容类型。此参数必须设置为 `application/json`。
Authorization	string	是	请求身份认证，接口使用金山云 API Key 进行身份认证。格式为 `Bearer KSC_API_KEY`。`KSC_API_KEY`的创建和使用可参考API Key相关内容。
X-DashScope-Async	string	是	异步处理配置参数。HTTP 请求只支持异步，必须设置为 `enable`。

请求参数

字段	类型	是否必填	描述
model	string	是	模型名称。示例值：`wan2.6-t2i`。
input	object	是	输入的基本信息。
input.messages	array	是	请求内容数组。当前仅支持单轮对话，即传入一组 `role`、`content` 参数，不支持多轮对话。
input.messages[].role	string	是	消息的角色。此参数必须设置为 `user`。
input.messages[].content	array	是	消息内容数组。
input.messages[].content[].text	string	是	正向提示词，用于描述期望生成的图像内容、风格和构图。支持中英文，长度不超过 2100 个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。仅支持传入一个 `text`，不传或传入多个将报错。
parameters	object	选填	图像处理参数。
parameters.negative_prompt	string	选填	反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制。支持中英文，长度不超过 500 个字符，超出部分将自动截断。
parameters.size	string	选填	输出图像的分辨率，格式为 `宽高`。默认值为 `12801280`。总像素在 [1280×1280, 14401×440] 之间且宽高比范围为 [1:4, 4:1]。例如，`768*2700` 符合要求。
parameters.n	integer	选填	生成图片的数量。取值范围为 1~4 张，默认为 4。
parameters.prompt_extend	bool	选填	是否开启 prompt 智能改写。开启后，将使用大模型优化正向提示词，对较短的提示词有明显提升效果，但增加 3~4 秒耗时。默认 `true`，开启智能改写。
parameters.watermark	bool	选填	是否添加水印标识，水印位于图片右下角，文案固定为"AI 生成"。默认 `false`，不添加水印。
parameters.seed	integer	选填	随机数种子，取值范围 [0, 2147483647]。使用相同的 `seed` 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。模型生成过程具有概率性，即使使用相同的 `seed`，也不能保证每次生成结果完全一致。

请求示例

curl --location 'https://kspmas.ksyun.com/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ***" \
--header 'X-DashScope-Async: enable' \
--data '{
  "model": "wan2.6-t2i",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "watermark": false,
    "n": 1,
    "negative_prompt": "",
    "size": "1280*1280"
  }
}'

返回参数

字段	类型	描述
output	object	任务输出信息。
output.task_id	string	任务 ID。查询有效期 24 小时。
output.task_status	string	任务状态，取值如下：`PENDING`（任务排队中）、`RUNNING`（任务处理中）、`SUCCEEDED`（任务执行成功）、`FAILED`（任务执行失败）、`CANCELED`（任务已取消）、`UNKNOWN`（任务不存在或状态未知）。
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。

返回示例

{
  "output": {
    "task_status": "PENDING",
    "task_id": "03XXXXX-XXXX-XXXX-XXXX-XXXXXX"
  },
  "request_id": "4909XXXX-XXXX-XXXX-XXXX-XXXXXX"
}

利用任务ID查询任务结果

请求信息

请求方法	请求路径
GET	https://kspmas.ksyun.com/api/v1/tasks/{task_id}

将 {task_id} 完整替换为上一步异步调用接口返回的 task_id 值。
task_id 查询有效期为 24 小时。

请求示例

curl -X GET https://kspmas.ksyun.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer ***"

返回参数

字段	类型	描述
request_id	string	请求唯一标识。可用于请求明细溯源和问题排查。
output	object	任务输出信息。
output.task_id	string	任务 ID。
output.task_status	string	任务状态，取值如下：`PENDING`（任务排队中）、`RUNNING`（任务处理中）、`SUCCEEDED`（任务执行成功）、`FAILED`（任务执行失败）、`CANCELED`（任务已取消）、`UNKNOWN`（任务不存在或状态未知）。
output.submit_time	string	任务提交时间。
output.scheduled_time	string	任务调度时间。
output.end_time	string	任务完成时间。
output.finished	boolean	任务是否结束。`true` 表示已结束，`false` 表示未结束。
output.choices	array	模型生成的输出内容。
output.choices[].finish_reason	string	任务停止原因，自然停止时为 `stop`。
output.choices[].message	object	模型返回的消息。
output.choices[].message.role	string	消息的角色，固定为 `assistant`。
output.choices[].message.content	array	消息内容数组。
output.choices[].message.content[].image	string	生成图像的 URL，图像格式为 PNG。链接有效期为 24 小时，请及时下载并保存图像。
output.choices[].message.content[].type	string	输出的类型，固定为 `imag

文档导读

上一篇：豆包Seedream

下一篇：最佳实践

纯净模式常规模式

纯净模式

点击可全屏预览文档内容