1. Vidu
梧柏API使用文档
WHBAI · Vidu
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Vidu
    • 语音合成 TTS
      POST
    • 文生视频
      POST
    • 图生视频
      POST
    • 首尾帧生视频
      POST
    • 参考生视频
      POST
    • 参考生图
      POST
    • 文生音频
      POST
    • 查询任务
      GET
  • vidu
    • 创建视频
      POST
    • 查询任务
      GET
  • 数据模型
    • ViduSampleRequest
    • PostEntV2Text2videoRequest
    • PostEntV2Img2videoRequest
    • PostEntV2StartEnd2videoRequest
    • PostEntV2Reference2videoRequest
    • PostEntV2Reference2imageRequest
    • PostEntV2Text2audioRequest
    • NewApiError
  1. Vidu

参考生图

POST
/ent/v2/reference2image
参考图片生成图像。

网站中的模型与调用示例#

创建图片生成任务#

官方文档:https://platform.vidu.cn/docs/reference-to-image

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "aspect_ratio": {
      "description": "比例参数,不同模型支持不同的比例:\nviduq1:默认值16:9,可选值:16:9、9:16、1:1、3:4、4:3\nviduq2:默认值16:9,可选值如下:16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2\n- auto:表示与首张输入图保持相同比例",
      "type": "string"
    },
    "callback_url": {
      "description": "Callback 协议\n需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致\n回调返回的“status”包括以下状态:\n- processing 任务处理中\n- success 任务完成(如发送失败,回调三次)\n- failed 任务失败(如发送失败,回调三次)\nVidu采用回调签名算法进行认证,详情见:回调签名算法",
      "type": "string"
    },
    "images": {
      "description": "图像参考\nviduq2:支持输入 0~7 张图片\nviduq1:支持输入 1~7 张图片\n模型将以此参数中传入的图片中的主题为参考,生成与图片中主体一致的视频。\n注1:支持传入图片 Base64 编码或图片URL(确保可访问)\n注2:图片支持 png、jpeg、jpg、webp格式\n注3:图片像素不能小于 128*128,且比例需要小于1:4或者4:1\n注4: 且大小不超过50M\n注5:请注意,http请求的post body不超过20MB,且编码必须包含适当的内容类型字符串,例如:\n\ndata:image/png;base64,{base64_encode}",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "model": {
      "description": "模型名称\n可选值:viduq2、viduq1\nviduq2:支持文生图、图片编辑、参考生图\nviduq1:支持参考生图",
      "type": "string"
    },
    "payload": {
      "description": "透传参数\n不做任何处理,仅数据传输\n注:最多 1048576个字符",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Pass-through parameter. Not processed; forwarded as-is. Max 1048576 characters."
        }
      }
    },
    "prompt": {
      "description": "文本提示词\n视频生成的文本描述,长度不能超过 2000 个字符\n注1:viduq2模型支持文生图,在使用viduq2模型,且没有上传任何images时,模型会使用该参数的文本内容生成图片",
      "type": "string"
    },
    "resolution": {
      "description": "分辨率参数,不同模型支持的分辨率不同:\nviduq1:默认1080p,可选项:1080p\nviduq2:默认1080p,可选项:1080p、2K、4K",
      "type": "string"
    },
    "seed": {
      "description": "随机种子参数\n当默认不传或者传0时,会使用随机数替代\n手动设置则使用设置的种子",
      "type": "string"
    }
  },
  "required": [
    "model",
    "prompt"
  ]
}

请求示例 · 示例 1#

{
  "model": "viduq1",
  "prompt": "一只可爱的小猫坐在窗台上,阳光洒在它的身上,温馨的画面"
}

响应示例 · 成功示例#

{
  "aspect_ratio": "auto",
  "callback_url": "",
  "created_at": "2026-01-20T07:08:12.262592985Z",
  "credits": 6,
  "cus_priority": 0,
  "images": [],
  "model": "viduq2",
  "payload": "",
  "prompt": "一只可爱的小猫坐在窗台上,阳光洒在它的身上,温馨的画面",
  "seed": 616519648,
  "state": "created",
  "task_id": "911092490931552256",
  "watermark": false
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "model": "viduq1",
    "prompt": "一只可爱的小猫坐在窗台上,阳光洒在它的身上,温馨的画面"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ent/v2/reference2image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "viduq1",
    "prompt": "一只可爱的小猫坐在窗台上,阳光洒在它的身上,温馨的画面"
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "task_id": "task_example_001"
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:24
上一页
参考生视频
下一页
文生音频
Built with