API调用 | Vidu API

使用步骤

POST https://api.vidu.cn/ent/v2/fine-tuned

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your_api_key}	将 {your_api_key} 替换为您的 Token

参数名	类型	是否必填	描述
fine_tuned_model_id	String	是	微调模型的id 需填写您创建的模型id
images	Array[String]	是	首帧图像，仅支持传入 1 张图像，用于生成视频起始帧。 - 支持图片 URL 或 Base64 编码，公网可访问。（base64 decode之后的字节长度需要小于 50M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,`\{base64_encode\}`）图片的限制条件： - 格式：png、jpeg、jpg、webp - 比例：长宽比需在 1:4 ~ 4:1 之间 - 大小：不超过 50MB
prompt	String	否	调用模型的提示词（即训练时使用的统一描述）建议不超过 1500 个字符v
seed	Int	否	随机种子默认值为 0 或不填将使用系统随机值；如需可复现生成结果，可手动设置
callback_url	String	否	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	描述
task_id	String	Vidu 生成的任务ID
state	String	处理状态 - created 创建成功 - queueing 任务排队中 - processing 任务处理中 - success 任务成功 - failed 任务失败
fine_tuned_model_id	String	本次调用的微调模型id
prompt	String	本次调用的提示词参数
images	Array[String]	本次调用的图像参数
seed	Int	本次调用的随机种子参数
created_at	String	任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "fine_tuned_model_id": "your_fine_tuned_model_id",
  "images": ["your_images_here"],
  "prompt": "text_prompt",
  "seed": random_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

字段

值

描述

Content-Type

application/json

数据交换格式

Authorization

Token {your_api_key}

将 {your_api_key} 替换为您的 Token

参数名	类型	是否必填	描述
fine_tuned_model_id	String	是	微调模型的id 需填写您创建的模型id
images	Array[String]	是	首帧图像，仅支持传入 1 张图像，用于生成视频起始帧。 - 支持图片 URL 或 Base64 编码，公网可访问。（base64 decode之后的字节长度需要小于 50M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,`\{base64_encode\}`）图片的限制条件： - 格式：png、jpeg、jpg、webp - 比例：长宽比需在 1:4 ~ 4:1 之间 - 大小：不超过 50MB
prompt	String	否	调用模型的提示词（即训练时使用的统一描述）建议不超过 1500 个字符v
seed	Int	否	随机种子默认值为 0 或不填将使用系统随机值；如需可复现生成结果，可手动设置
callback_url	String	否	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	描述
task_id	String	Vidu 生成的任务ID
state	String	处理状态 - created 创建成功 - queueing 任务排队中 - processing 任务处理中 - success 任务成功 - failed 任务失败
fine_tuned_model_id	String	本次调用的微调模型id
prompt	String	本次调用的提示词参数
images	Array[String]	本次调用的图像参数
seed	Int	本次调用的随机种子参数
created_at	String	任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "fine_tuned_model_id": "your_fine_tuned_model_id",
  "images": ["your_images_here"],
  "prompt": "text_prompt",
  "seed": random_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

搜索文档

搜索文档