> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidu 视频接口参考

> 生数科技 Vidu 视频生成与参考图生视频

## 查询任务

`GET /ent/v2/tasks/{id}/creations`

根据任务 ID 查询生成结果。

### 请求参数 (Query / Path)

<ParamField path="id" type="string" required>
  路径中的资源 / 任务 ID
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/ent/v2/tasks/{id}/creations" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "status": "succeed"
  },
  "message": "success"
}
```

***

## 查询任务

`GET /vidu-native/video/generations/{task_id}`

给定一个提示，该模型将返回一个或多个预测的完成，并且还可以返回每个位置的替代标记的概率。

为提供的提示和参数创建完成

### 请求参数 (Query / Path)

<ParamField path="task_id" type="string" required>
  异步任务 ID
</ParamField>

<ParamField header="Content-Type" type="string" required>
  请求体 Content-Type，一般为 application/json
</ParamField>

<ParamField header="Accept" type="string" required>
  期望的响应 Content-Type
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

<ParamField header="X-Forwarded-Host" type="string">
  转发原始 Host（代理场景）
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/vidu-native/video/generations/{task_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

````json theme={null}
{
  "enhanced_prompt": "```\nA surreal and whimsical digital painting of a majestic brown cow with large, feathered wings soaring gracefully through a vibrant blue sky. The cow has a joyful expression, its tail streaming behind it as it flies among fluffy white clouds. Below, a patchwork of green farmland stretches into the distance, with tiny farm buildings and a group of astonished farmers looking up in amazement. The scene is bathed in warm golden sunlight, creating a dreamlike and magical atmosphere. Art style inspired by fantasy illustrations with soft brushstrokes and rich, saturated colors.\n```",
  "id": "033fa60e-f37c-4ff6-a44d-5585ffea938d",
  "status": "pending",
  "status_update_time": 1750323167003
}
````

***

## 语音合成 TTS

`POST /ent/v2/audio-tts`

文本转语音。

### 请求体参数 (Body)

<ParamField body="text" type="string" required>
  待合成文本
</ParamField>

<ParamField body="voice_setting_pitch" type="integer">
  音高
</ParamField>

<ParamField body="voice_setting_speed" type="number">
  语速
</ParamField>

<ParamField body="voice_setting_voice_id" type="string" required>
  音色 ID
</ParamField>

<ParamField body="voice_setting_volume" type="integer">
  音量
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/audio-tts" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 图生视频

`POST /ent/v2/img2video`

以首帧图片生成视频。

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  宽高比，如 16:9、9:16、1:1
</ParamField>

<ParamField body="audio" type="boolean">
  音频相关参数或 URL
</ParamField>

<ParamField body="callback_url" type="string">
  任务完成回调 URL
</ParamField>

<ParamField body="duration" type="integer">
  视频时长（秒）
</ParamField>

<ParamField body="images" type="array" required>
  首帧图片 URL，仅 1 张
</ParamField>

<ParamField body="model" type="string" required>
  模型名称
</ParamField>

<ParamField body="prompt" type="string">
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，如 720p/1080p
</ParamField>

<ParamField body="seed" type="integer">
  随机种子，0 为随机
</ParamField>

<ParamField body="watermark" type="boolean">
  是否添加水印
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "duration": 5,
  "images": [
    "https://example.com/frame.jpg"
  ],
  "model": "viduq2-pro",
  "prompt": "镜头缓缓推进"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/img2video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "duration": 5,
  "images": [
    "https://example.com/frame.jpg"
  ],
  "model": "viduq2-pro",
  "prompt": "镜头缓缓推进"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 参考生图

`POST /ent/v2/reference2image`

参考图片生成图像。

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  宽高比，如 16:9、9:16、1:1
</ParamField>

<ParamField body="images" type="array">
  图片 URL 或 Base64 列表
</ParamField>

<ParamField body="model" type="string" required>
  模型名称
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，如 720p/1080p
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/reference2image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 参考生视频

`POST /ent/v2/reference2video`

多图/视频参考生成视频。

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  宽高比，如 16:9、9:16、1:1
</ParamField>

<ParamField body="callback_url" type="string">
  任务完成回调 URL
</ParamField>

<ParamField body="duration" type="integer">
  视频时长（秒）
</ParamField>

<ParamField body="images" type="array">
  图片 URL 或 Base64 列表
</ParamField>

<ParamField body="model" type="string" required>
  模型名称
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，如 720p/1080p
</ParamField>

<ParamField body="seed" type="integer">
  随机种子，0 为随机
</ParamField>

<ParamField body="subjects" type="array">
  主体 / 角色参考列表
</ParamField>

<ParamField body="watermark" type="boolean">
  是否添加水印
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/reference2video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 首尾帧生视频

`POST /ent/v2/start-end2video`

首帧 + 尾帧生成过渡视频。

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  宽高比，如 16:9、9:16、1:1
</ParamField>

<ParamField body="callback_url" type="string">
  任务完成回调 URL
</ParamField>

<ParamField body="duration" type="integer">
  视频时长（秒）
</ParamField>

<ParamField body="images" type="array" required>
  图片 URL 或 Base64 列表
</ParamField>

<ParamField body="model" type="string" required>
  模型名称
</ParamField>

<ParamField body="prompt" type="string">
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，如 720p/1080p
</ParamField>

<ParamField body="seed" type="integer">
  随机种子，0 为随机
</ParamField>

<ParamField body="watermark" type="boolean">
  是否添加水印
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/start-end2video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 文生音频

`POST /ent/v2/text2audio`

根据文本描述生成音频。

### 请求体参数 (Body)

<ParamField body="duration" type="number">
  2–10 秒
</ParamField>

<ParamField body="model" type="string" required>
  模型名称 / 型号 ID
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/text2audio" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 文生视频

`POST /ent/v2/text2video`

根据文本提示词生成视频。

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  宽高比，如 16:9、9:16、1:1
</ParamField>

<ParamField body="bgm" type="boolean">
  是否添加背景音乐
</ParamField>

<ParamField body="callback_url" type="string">
  任务完成回调 URL
</ParamField>

<ParamField body="duration" type="integer">
  视频时长（秒）
</ParamField>

<ParamField body="model" type="string" required>
  模型名称
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，如 720p/1080p
</ParamField>

<ParamField body="seed" type="integer">
  随机种子，0 为随机
</ParamField>

<ParamField body="style" type="string">
  风格参数
</ParamField>

<ParamField body="watermark" type="boolean">
  是否添加水印
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "duration": 5,
  "model": "viduq2",
  "prompt": "一只猫在草地上奔跑"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/ent/v2/text2video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "duration": 5,
  "model": "viduq2",
  "prompt": "一只猫在草地上奔跑"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}
```

***

## 创建视频

`POST /vidu-native/video/generations`

### 请求参数 (Query / Path)

<ParamField header="Content-Type" type="string" required>
  请求体 Content-Type，一般为 application/json
</ParamField>

<ParamField header="Accept" type="string" required>
  期望的响应 Content-Type
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string" required>
  可选为 2:3, 3:2, 1:1
</ParamField>

<ParamField body="images" type="array" required>
  图片链接
</ParamField>

<ParamField body="model" type="string" required>
  模型名称。常用枚举：
  viduq2
  viduq2-pro
  viduq2-turbo
  viduq3-pro
  viduq3-turbo
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="size" type="string" required>
  720P或者1080P
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "1:1",
  "images": [
    "https://example.com/ref.png"
  ],
  "model": "viduq2",
  "prompt": "一只可爱的小猫在花园里玩耍",
  "settings": {
    "settings": {
      "aspect_ratio": "16:9",
      "duration": 4,
      "resolution": "1080p"
    }
  },
  "size": "1080P"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/vidu-native/video/generations" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "images": [
    "https://example.com/ref.png"
  ],
  "model": "viduq2",
  "prompt": "一只可爱的小猫在花园里玩耍",
  "settings": {
    "settings": {
      "aspect_ratio": "16:9",
      "duration": 4,
      "resolution": "1080p"
    }
  },
  "size": "1080P"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "id": "viduq2:1762241017-xTL0P9HvGF",
  "status": "pending",
  "status_update_time": 1762241017286
}
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.