Wan 2.7 Pro 文生图

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "alibaba/wan-2.7/text-to-image-pro",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "size": "1024x1024",
    "n": 1
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "alibaba/wan-2.7/text-to-image-pro",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "size": "1024x1024",
    "n": 1
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

使用 Wan 2.7 Pro 创作图像变体，通过详细的提示词引导主体、风格和构图。

模型

alibaba/wan-2.7/text-to-image-pro - 根据文本提示词生成图像。

功能

根据文本提示词生成图像。
通过 n 控制输出图像数量。

需要参考图时，请使用对应的图像编辑接口。

输出选项

图像尺寸

size：可选。默认：1024x1024。
预设：512x512、1024x1024、768x1024、1024x768、576x1024、1024x576。
自定义尺寸时，提供包含整数 width 和 height 的对象，两者都必须为正数。

图像数量

n：可选。要生成的图像数量。1 到 4 的整数。默认：1。

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。只发送本工作流支持的 input 字段。不支持的 input 字段会在扣除积分前被拒绝。

提示词

prompt：必填。描述期望的图像。长度：1-5,000 个字符。
提供时不能为空。

种子

seed：可选。设置生成种子。整数。

计费因素

计费取决于所选模型版本和输出图像数量（n）。输出尺寸不会额外计费。积分在提交时扣除，任务失败会退还。

授权

Authorization

string

header

必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和 callback_url 放在根级。未知的根级字段会被忽略；不支持的 input 字段会被拒绝。

model

string

必填

示例:

"alibaba/wan-2.7/text-to-image-pro"

input

object

必填

此公开接口的输入参数。需要提供参考图时请使用图像编辑接口。

Show child attributes

callback_url

string | null

可选的公开 HTTP(S) 接口，用于接收任务完成通知。建议使用 HTTPS。省略、设为 null 或空字符串即关闭回调。

响应

任务已提交

code

enum<integer>

必填

可用选项:

200

data

object

必填

Show child attributes

​模型

​功能

​输出选项

​图像尺寸

​图像数量

​高级参数

​提示词

​种子

​计费因素

授权

请求体

响应

模型

功能

输出选项

图像尺寸

图像数量

高级参数

提示词

种子

计费因素