# 创建视频任务（ARK 兼容路径）

与 `POST /v1/videos/generations` 完全等效，但响应体直接采用官方 Volcengine Ark 的
seedance 格式：`id` 字段就是上游任务 ID，无 `upstream_id` 包裹。

用途：让已经接入官方 ARK SDK 的客户端只改 `base_url` 和 `api_key` 即可切到 XRToken。
官方 SDK 默认前缀是 `/api/v3`，XRToken 同时接受 `/api/v3`、`/v3`、`/api/v1`、`/v1`。
请求体、鉴权方式、计费、模型路由全部与 `/v1/videos/generations` 共用一套实现。

## POST /v1/contents/generations/tasks

> 创建视频任务（ARK 兼容路径）

与 `POST /v1/videos/generations` 完全等效，但响应体直接采用官方 Volcengine Ark 的
seedance 格式：`id` 字段就是上游任务 ID，无 `upstream_id` 包裹。

用途：让已经接入官方 ARK SDK 的客户端只改 `base_url` 和 `api_key` 即可切到 XRToken。
官方 SDK 默认前缀是 `/api/v3`，XRToken 同时接受 `/api/v3`、`/v3`、`/api/v1`、`/v1`。
请求体、鉴权方式、计费、模型路由全部与 `/v1/videos/generations` 共用一套实现。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  视频生成模型 ID，可通过 `GET /v1/models` 过滤 `type: video` 获取。
- **content** `object[]` **(required)**  
  输入给模型的信息，支持文本、图片、视频、音频。支持以下组合：
- **content[].type** ``text` | `image_url` | `video_url` | `audio_url`` **(required)**  
  输入内容的类型：
- **content[].text** `string`  
  文本提示词（当 `type: text` 时使用）。支持中英文，建议中文不超过 500 字
- **content[].image_url** `object`  
  图片对象（当 `type: image_url` 时使用）
- **content[].role** ``first_frame` | `last_frame` | `reference_image` | `reference_video` | `reference_audio``  
  图片/视频/音频的位置或用途：
- **content[].video_url** `object`  
  视频对象（当 `type: video_url` 时使用，仅 Seedance 2.0）
- **content[].audio_url** `object`  
  音频对象（当 `type: audio_url` 时使用，仅 Seedance 2.0）
- **resolution** ``480p` | `720p` | `1080p` | `768P` | `2K`` (default: `720p`)  
  输出视频分辨率。
- **ratio** ``16:9` | `4:3` | `1:1` | `3:4` | `9:16` | `21:9` | `adaptive`` (default: `adaptive`)  
  输出视频宽高比。
- **duration** `integer` (default: `5`)  
  输出视频时长（秒），整数。设为 `-1` 由模型自主选择合适时长（注意时长与计费相关）。
- **seed** `integer` (default: `-1`)  
  随机种子，用于控制生成的随机性。取值范围 [-1, 2^32-1]。
- **generate_audio** `boolean` (default: `true`)  
  是否生成有声视频。模型会基于提示词与视觉内容，自动生成匹配的人声、音效及背景音乐。
- **return_last_frame** `boolean` (default: `false`)  
  是否返回视频尾帧图像（png 格式，无水印，与视频同分辨率）。
- **camera_fixed** `boolean` (default: `false`)  
  是否固定摄像头。
- **watermark** `boolean` (default: `false`)  
  生成视频是否包含水印
- **service_tier** ``default` | `flex`` (default: `default`)  
  服务等级（不支持修改已提交任务的服务等级）：
- **callback_url** `string`  
  任务终态回调地址。任务进入 `succeeded` / `failed` 时，XRToken 会向此 URL 发送一次 `POST` 请求。
- **safety_identifier** `string`  
  终端用户唯一标识符，用于安全审计。建议传入用户 ID 的哈希值，长度不超过 64 字符。

### Response

- **id** `string`  
  上游 seedance 任务 ID。后续轮询 / 取消用同一个 id
- **model** `string`  
  
- **status** `string`  
  
- **created_at** `string`  
  

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: