<!-- 本文件由 scripts/docs/build-model-api-reference.mjs 生成，请勿手改。 -->
<!-- 重新生成：node scripts/docs/build-model-api-reference.mjs --write -->

# 模型 API 参考

这份文档由线上目录**直接生成**：下面每一个模型、每一条端点、每一个参数，都是当前真实可调用的。

- 接口地址：`https://api.xsai5.xyz/v1`
- 鉴权：请求头 `Authorization: Bearer <你的 API Key>`
- 计费单位为人民币（¥）。

> **给 agent 的提醒**：模型清单会变。请在运行时调 `GET /v1/models` 取当前列表，
> 不要把模型名写死在代码里。视频模型还可以调 `GET /v1/videos/capabilities` 取实时参数。

## 怎么调

### 对话模型

同一个模型可以用三种协议调用，请求体会被自动转换，效果一致 —— 用你手上 SDK 最顺的那种即可：

| 协议 | 端点 |
| --- | --- |
| OpenAI | `POST /v1/chat/completions`、`/v1/responses`、`/v1/completions` |
| Anthropic | `POST /v1/messages` |
| Gemini | `POST /v1/gemini/generateContent`、`/v1/gemini/streamGenerateContent` |

```bash
curl https://api.xsai5.xyz/v1/chat/completions \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'
```

### 图像模型

`POST /v1/images/generations` 文生图；支持图生图的模型另有 `POST /v1/images/edits`（multipart）
与 `POST /v1/images/jobs`（异步，适合批量）。

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的柴犬",
    "size": "1024x1024",
    "n": 1,
    "background": "transparent",
    "output_format": "png"
  }'
```

常用字段：`size`、`n`、`quality`、`output_format`(`png`/`jpeg`/`webp`)、`background`(`auto`/`transparent`/`opaque`)。

> `background: "transparent"` 需要 `output_format` 为 `png` 或 `webp` —— JPEG 没有透明通道。
> 不支持指定背景的模型会**在请求时直接报错并说明**，不会扣费给你一张背景不对的图。

> ⛔ **不要发 `mask`**：带 `mask` 的图片请求一律返回 `400` 且**不计费**。
> 实测当前在售的图片能力没有一条做真正的像素级局部重绘（遮罩不会生效、连画布尺寸都会变），
> 所以这个能力我们不提供。只想改局部时，请把要保留的内容写进 `prompt`。

### 视频模型

异步任务：`POST /v1/videos` 创建，返回任务 id；`GET /v1/videos/{id}` 轮询到完成。

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 5,
    "aspect_ratio": "16:9"
  }'
```

可用字段：`prompt`、`seconds`、`aspect_ratio`、`resolution`、参考素材 `images` / `videos` / `audios`、
首尾帧 `first_image_url` + `last_image_url`。**每个模型认哪些、上限多少各不相同，见下方各模型条目。**
发了模型不支持的组合会在**下单前**被拒绝并说明原因，不计费。

### 嵌入 / 重排

`POST /v1/embeddings`（字段 `model`、`input`）；`POST /v1/rerank`（字段 `model`、`query`、`documents`）。

---

## 对话模型（26）

### `claude-opus-5`

Claude Opus 5 · Anthropic

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：1,000,000 tokens
- 计费：输入 ¥5 / 百万 tokens，输出 ¥25 / 百万 tokens

### `claude-opus-5-5`

Claude Opus 5.5 · Anthropic

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,000,000 tokens
- 计费：输入 ¥4 / 百万 tokens，输出 ¥20 / 百万 tokens

### `claude-sonnet-5`

Claude Sonnet 5 · Anthropic

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：1,000,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥10 / 百万 tokens

### `claude-sonnet-5-5`

Claude Sonnet 5.5 · Anthropic

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,000,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥10 / 百万 tokens

### `deepseek-v4.1-flash`

DeepSeek V4.1 极速 · DeepSeek

- 能力：流式 `stream: true`、工具调用 `tools`、推理内容
- 上下文：1,048,576 tokens
- 计费：输入 ¥1 / 百万 tokens，输出 ¥4 / 百万 tokens

### `deepseek-v4.1-flash-free`

DeepSeek V4.1 极速（免费） · DeepSeek

- 能力：流式 `stream: true`、工具调用 `tools`
- 计费：输入 ¥1 / 百万 tokens，输出 ¥4 / 百万 tokens

### `gemini-3.8-flash`

Gemini 3.8 极速 · Google

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：1,048,576 tokens
- 计费：输入 ¥0.75 / 百万 tokens，输出 ¥3.75 / 百万 tokens

### `gemini-4-argon`

Gemini 4 Argon · Google

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、音频输入、推理内容
- 上下文：1,048,576 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥10 / 百万 tokens

### `glm-5.3`

智谱 GLM 5.3 · 智谱 AI

- 能力：流式 `stream: true`、工具调用 `tools`、推理内容
- 上下文：1,000,000 tokens
- 计费：输入 ¥8 / 百万 tokens，输出 ¥28 / 百万 tokens

### `glm-5.3-flash`

智谱 GLM 5.3 极速 · 智谱 AI

- 能力：流式 `stream: true`、工具调用 `tools`
- 上下文：1,000,000 tokens
- 计费：输入 ¥0.8 / 百万 tokens，输出 ¥2.8 / 百万 tokens

### `gpt-5.5`

GPT 5.5 · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,050,000 tokens
- 计费：输入 ¥5 / 百万 tokens，输出 ¥30 / 百万 tokens

### `gpt-5.6-sol`

GPT 5.6 Sol · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：1,050,000 tokens
- 计费：输入 ¥5 / 百万 tokens，输出 ¥30 / 百万 tokens

### `gpt-5.6-terra`

GPT 5.6 Terra · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：1,050,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥12 / 百万 tokens

### `gpt-6-astra`

GPT 6 Astra · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,050,000 tokens
- 计费：输入 ¥10 / 百万 tokens，输出 ¥50 / 百万 tokens

### `gpt-6-sol`

GPT 6 Sol · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,050,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥10 / 百万 tokens

### `gpt-6.1-sol`

GPT 6.1 Sol · OpenAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,050,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥10 / 百万 tokens

### `grok-4.6`

Grok 4.6 · xAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：500,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥6 / 百万 tokens

### `grok-4.7`

Grok 4.7 · xAI

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 上下文：500,000 tokens
- 计费：输入 ¥2 / 百万 tokens，输出 ¥6 / 百万 tokens

### `kimi-k3`

Kimi K3 · Moonshot AI

- 能力：流式 `stream: true`、工具调用 `tools`
- 上下文：1,048,576 tokens
- 计费：输入 ¥20 / 百万 tokens，输出 ¥100 / 百万 tokens

### `mimo-v2.6-flash`

Mimo V2.6 极速 · 小米

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、音频输入、推理内容
- 上下文：1,048,576 tokens
- 计费：输入 ¥1 / 百万 tokens，输出 ¥2 / 百万 tokens

### `mimo-v2.6-pro`

Mimo V2.6 专业 · 小米

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、音频输入、推理内容
- 上下文：1,048,576 tokens
- 计费：输入 ¥3 / 百万 tokens，输出 ¥6 / 百万 tokens

### `MiniMax-M3`

MiniMax M3 · MiniMax

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,048,576 tokens
- 计费：输入 ¥4.2 / 百万 tokens，输出 ¥16.8 / 百万 tokens

### `qwen3.5-4b`

Qwen3.5 4b · 阿里云

- 能力：流式 `stream: true`、工具调用 `tools`
- 计费：输入 ¥0 / 百万 tokens，输出 ¥0 / 百万 tokens

### `qwen3.8-27b-uncensored`

Qwen3.8 27b Uncensored · 阿里云

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入
- 计费：输入 ¥0 / 百万 tokens，输出 ¥0 / 百万 tokens

### `qwen3.8-flash`

Qwen3.8 极速 · 阿里云

- 能力：流式 `stream: true`、工具调用 `tools`
- 上下文：1,000,000 tokens
- 计费：输入 ¥0.113 / 百万 tokens，输出 ¥0.382 / 百万 tokens

### `qwen3.8-max`

Qwen3.8 旗舰 · 阿里云

- 能力：流式 `stream: true`、工具调用 `tools`、图片输入、推理内容
- 上下文：1,000,000 tokens
- 计费：输入 ¥12 / 百万 tokens，输出 ¥36 / 百万 tokens

## 图像模型（5）

### `gemini-3.1-flash-image`

Gemini 3.1 极速 (图像) · Google

- 计费：¥0.15 / 张
- 端点：`POST /v1/images/generations`、`POST /v1/images/edits`（multipart，图生图）、`POST /v1/images/jobs`（异步）

| 字段 | 取值 | 发了会怎样 |
| --- | --- | --- |
| `prompt` *(必填)* | string | 按原样送达模型 |
| `image` | image[] | 按原样送达模型 |
| `size` | image-size | **发了不生效**：请求前会被丢弃（不会报错，但也不会起作用） |
| `n` | integer:1..4 | **发了不生效**：请求前会被丢弃（不会报错，但也不会起作用） |
| `quality` | auto \| low \| medium \| high \| standard \| hd | **发了不生效**：请求前会被丢弃（不会报错，但也不会起作用） |
| `output_format` | png \| jpeg \| webp | **发了不生效**：请求前会被丢弃（不会报错，但也不会起作用） |
| `background` | string | **不接受**：发了会直接返回参数错误 |
| `input_fidelity` | string | **不接受**：发了会直接返回参数错误 |

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "一只戴墨镜的柴犬"
  }'
```

### `gpt-image-2`

GPT (图像) 2 · OpenAI

- 计费：¥0.15 / 张
- 端点：`POST /v1/images/generations`、`POST /v1/images/edits`（multipart，图生图）、`POST /v1/images/jobs`（异步）

| 字段 | 取值 | 发了会怎样 |
| --- | --- | --- |
| `prompt` *(必填)* | string | 按原样送达模型 |
| `image` | image[] | 按原样送达模型 |
| `size` | image-size | 会照发，但不保证严格遵守 |
| `n` | integer:1..10 | 严格生效：结果不符会判为失败，不会把不对的结果交给你 |
| `quality` | auto \| low \| medium \| high \| standard \| hd | 会照发，但不保证严格遵守 |
| `output_format` | png \| jpeg \| webp | 会照发，但不保证严格遵守 |
| `background` | auto \| transparent \| opaque | 会照发，但不保证严格遵守 |
| `input_fidelity` | low \| high | 会照发，但不保证严格遵守 |

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的柴犬",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png"
  }'
```

> 透明背景需要 `output_format` 为 `png` 或 `webp`。JPEG 没有透明通道，配 `transparent` 会被直接拒绝 —— 我们宁可报错，也不给你一张看起来对、其实是白底的图。

### `gpt-image-2.5`

GPT (图像) 2.5 · OpenAI

- 计费：¥0.25 / 张
- 端点：`POST /v1/images/generations`、`POST /v1/images/edits`（multipart，图生图）、`POST /v1/images/jobs`（异步）

| 字段 | 取值 | 发了会怎样 |
| --- | --- | --- |
| `prompt` *(必填)* | string | 按原样送达模型 |
| `image` | image[] | 按原样送达模型 |
| `size` | image-size | 会照发，但不保证严格遵守 |
| `n` | integer:1..10 | 严格生效：结果不符会判为失败，不会把不对的结果交给你 |
| `quality` | auto \| low \| medium \| high \| standard \| hd | 会照发，但不保证严格遵守 |
| `output_format` | png \| jpeg \| webp | 会照发，但不保证严格遵守 |
| `background` | auto \| transparent \| opaque | 会照发，但不保证严格遵守 |
| `input_fidelity` | low \| high | 会照发，但不保证严格遵守 |

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "一只戴墨镜的柴犬",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png"
  }'
```

> 透明背景需要 `output_format` 为 `png` 或 `webp`。JPEG 没有透明通道，配 `transparent` 会被直接拒绝 —— 我们宁可报错，也不给你一张看起来对、其实是白底的图。

### `grok-imagine-image-2.0`

Grok Imagine (图像) 2.0 · xAI

- 计费：¥0.15 / 张
- 端点：`POST /v1/images/generations`、`POST /v1/images/edits`（multipart，图生图）、`POST /v1/images/jobs`（异步）

| 字段 | 取值 | 发了会怎样 |
| --- | --- | --- |
| `prompt` *(必填)* | string | 按原样送达模型 |
| `image` | image[] | 按原样送达模型 |
| `size` | image-size | 会照发，但不保证严格遵守 |
| `n` | integer:1..10 | 会照发，但不保证严格遵守 |
| `quality` | auto \| low \| medium \| high \| standard \| hd | 会照发，但不保证严格遵守 |
| `output_format` | png \| jpeg \| webp | 会照发，但不保证严格遵守 |
| `background` | auto \| transparent \| opaque | **只接受 `auto`**：这个模型没有指定背景的能力，发 `transparent` / `opaque` 会在请求前直接返回错误并说明，不计费 |
| `input_fidelity` | low \| high | 会照发，但不保证严格遵守 |

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "一只戴墨镜的柴犬",
    "size": "1024x1024"
  }'
```

### `qwen-image-2.1`

通义千问 (图像) 2.1 · 阿里云

- 计费：¥0 / 张
- 端点：`POST /v1/images/generations` —— 只支持文生图

| 字段 | 取值 | 发了会怎样 |
| --- | --- | --- |
| `prompt` *(必填)* | string | 按原样送达模型 |
| `size` | image-size | 会照发，但不保证严格遵守 |
| `n` | integer:1..10 | 会照发，但不保证严格遵守 |
| `quality` | auto \| low \| medium \| high \| standard \| hd | 会照发，但不保证严格遵守 |
| `output_format` | png \| jpeg \| webp | 会照发，但不保证严格遵守 |
| `background` | auto \| transparent \| opaque | **只接受 `auto`**：这个模型没有指定背景的能力，发 `transparent` / `opaque` 会在请求前直接返回错误并说明，不计费 |

```bash
curl https://api.xsai5.xyz/v1/images/generations \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.1",
    "prompt": "一只戴墨镜的柴犬",
    "size": "1024x1024"
  }'
```

## 视频模型（4）

### `minimax-h3`

Minimax H3 · MiniMax

- 计费：¥5 / 条（时长不影响价格）
- 端点：`POST /v1/videos` 创建任务 → `GET /v1/videos/{id}` 轮询
- 档位：`2K` / `480P` / `768P` / `标准` —— **不同档位能力不同**，见下

#### 2K 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 秒；只接受这些值 |
| `resolution` | `2K` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive | 画幅 |
| `images` | URL 数组，最多 9 个 | 参考图 |
| `videos` | URL 数组，最多 3 个 | 参考视频 |
| `audios` | URL 数组，最多 3 个 | 参考音频 |
| `first_image_url` / `last_image_url` | 图片 URL | 首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 5,
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'
```

#### 480P 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 秒；只接受这些值 |
| `resolution` | `480P` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive | 画幅 |
| `images` | URL 数组，最多 9 个 | 参考图 |
| `videos` | URL 数组，最多 3 个 | 参考视频 |
| `audios` | URL 数组，最多 3 个 | 参考音频 |
| `first_image_url` / `last_image_url` | 图片 URL | 首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 6,
    "resolution": "480P",
    "aspect_ratio": "16:9"
  }'
```

#### 768P 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 秒；只接受这些值 |
| `resolution` | `768P` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive | 画幅 |
| `images` | URL 数组，最多 9 个 | 参考图 |
| `videos` | URL 数组，最多 3 个 | 参考视频 |
| `audios` | URL 数组，最多 3 个 | 参考音频 |
| `first_image_url` / `last_image_url` | 图片 URL | 首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9"
  }'
```

#### 标准 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 秒；只接受这些值 |
| `images` | URL 数组，最多 9 个 | 参考图 |
| `videos` | — | 不支持参考视频 |
| `audios` | URL 数组，最多 3 个 | 参考音频 |
| `first_image_url` / `last_image_url` | — | 不支持首尾帧 |
| — | — | 标准 档不支持首尾帧，其他档可以用。 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 5
  }'
```

### `omni`

Omni 视频 · Google

- 计费：¥2.43 / 条（时长不影响价格）
- 端点：`POST /v1/videos` 创建任务 → `GET /v1/videos/{id}` 轮询

#### 参数

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 4 / 6 / 8 / 10 / 20 / 30 / 40 | 秒；只接受这些值 |
| `resolution` | `720p` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 9:16 | 画幅 |
| `images` | URL 数组，最多 5 个 | 参考图 |
| `videos` | URL 数组，最多 2 个 | 参考视频 |
| `audios` | — | 不支持参考音频 |
| `first_image_url` / `last_image_url` | 图片 URL | 首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
```

### `seedance-2.0`

Seedance 2.0（9图） · 字节跳动

- 计费：¥8.7 / 条（时长不影响价格）
- 端点：`POST /v1/videos` 创建任务 → `GET /v1/videos/{id}` 轮询

#### 参数

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 5 / 10 / 15 | 秒；只接受这些值 |
| `resolution` | `720p` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 9:16 / 1:1 | 画幅 |
| `images` | URL 数组，最多 9 个 | 参考图 |
| `videos` | — | 不支持参考视频 |
| `audios` | — | 不支持参考音频 |
| `first_image_url` / `last_image_url` | — | 不支持首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
```

### `seedance2.5`

Seedance 2.5（30秒 720p） · 字节跳动

- 计费：¥9 / 条（时长不影响价格）
- 端点：`POST /v1/videos` 创建任务 → `GET /v1/videos/{id}` 轮询
- 档位：`720p` / `标准` —— **不同档位能力不同**，见下

#### 720p 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 30 | 秒；只接受这些值 |
| `resolution` | `720p` | 选这一档就传这个值 |
| `aspect_ratio` | 16:9 / 9:16 / 1:1 / 21:9 / 4:3 / 3:4 | 画幅 |
| `images` | URL 数组，最多 30 个 | 参考图 |
| `videos` | URL 数组，最多 10 个 | 参考视频 |
| `audios` | URL 数组，最多 10 个 | 参考音频 |
| `first_image_url` / `last_image_url` | — | 不支持首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.5",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 30,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
```

#### 标准 档

| 字段 | 取值 | 说明 |
| --- | --- | --- |
| `prompt` *(必填)* | 文本 | 想生成什么 |
| `seconds` | 30 | 秒；只接受这些值 |
| `images` | — | 不支持参考图 |
| `videos` | — | 不支持参考视频 |
| `audios` | — | 不支持参考音频 |
| `first_image_url` / `last_image_url` | — | 不支持首尾帧 |

```bash
curl https://api.xsai5.xyz/v1/videos \
  -H "Authorization: Bearer $XSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.5",
    "prompt": "一只柴犬在雪地里奔跑",
    "seconds": 30
  }'
```

## 嵌入模型（2）

### `Qwen/Qwen3-Embedding-8B`

Qwen/Qwen3 (嵌入) 8B · 阿里云

- 计费：¥0.28 / 百万 tokens

### `Qwen/Qwen3-VL-Embedding-8B`

Qwen/Qwen3 (视觉) (嵌入) 8B · 阿里云

- 计费：¥0.7 / 百万 tokens

## 重排模型（2）

### `Qwen/Qwen3-Reranker-8B`

Qwen/Qwen3 Reranker 8B · 阿里云

- 计费：¥0.28 / 百万 tokens

### `Qwen/Qwen3-VL-Reranker-8B`

Qwen/Qwen3 (视觉) Reranker 8B · 阿里云

- 计费：¥0.7 / 百万 tokens