典名词元典名词元首页
API 文档
AI 模型接口图像Vidu

图片生成

POST
/api/v1/image/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称,固定值: viduq1-image

images?array<string>

图像参考 viduq2:支持输入 0~7 张图片 viduq1:支持输入 1~7 张图片

prompt*string

文本提示词 视频生成的文本描述,长度不能超过 2000 个字符 注1:viduq2模型支持文生图,在使用viduq2模型,且没有上传任何images时,模型会使用该参数的文本内容生成图片

seed*integer

随机种子参数 当默认不传或者传0时,会使用随机数替代 手动设置则使用设置的种子

aspect_ratio*string

比例参数,不同模型支持不同的比例: viduq1:默认值16:9,可选值:16:9、9:16、1:1、3:4、4:3 viduq2:默认值16:9,可选值如下:16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2

  • auto:表示与首张输入图保持相同比例
resolution*string

分辨率参数,不同模型支持的分辨率不同: viduq1:默认1080p,可选项:1080p viduq2:默认1080p,可选项:1080p、2K、4K

payload*string

透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符

callback_url*string

Callback 协议 需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的“status”包括以下状态:

  • processing 任务处理中
  • success 任务完成(如发送失败,回调三次)
  • failed 任务失败(如发送失败,回调三次)
_action*string

固定值i2i

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string",    "seed": 0,    "aspect_ratio": "string",    "resolution": "string",    "payload": "string",    "callback_url": "string",    "_action": "string"  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}