# 视频模型

当前 ViewMax 视频模型、支持的模式和价格，以及如何读取 GET /api/v1/models。

`GET /api/v1/models` 公开可读，是每个模型的模式、选项、默认值和价格的事实来源。创建任务前请先读取它。响应最多缓存一小时。

## 模型目录

| 模型                    | 厂商              | 模式                                                                               | 价格                    | 参考页                                           |
| ----------------------- | ----------------- | ---------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------ |
| `viewmax-c1`            | ViewMax           | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 2 积分/秒（2–30）       | [ViewMax](https://viewmax.studio/zh/docs/api/models/viewmax)           |
| `viewmax-turbo`         | ViewMax           | text-to-video, image-to-video, frames-to-video                                     | 10–16 积分/秒（50–240） | [ViewMax](https://viewmax.studio/zh/docs/api/models/viewmax)           |
| `minimax-h3`            | MiniMax           | text-to-video, image-to-video, video-to-video, frames-to-video, reference-to-video | 3–4 积分/秒（12–60）    | [MiniMax H3](https://viewmax.studio/zh/docs/api/models/minimax-h3)     |
| `seedance-2-5`          | ByteDance         | text-to-video, image-to-video, video-to-video, frames-to-video, reference-to-video | 12–40 积分/秒           | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedance-2-0`          | ByteDance         | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 14–262 积分/秒          | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedance-2-0-fast`     | ByteDance         | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 10–33 积分/秒           | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedance-2-mini`       | ByteDance         | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 4–12 积分/秒            | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedance-1-5-pro`      | ByteDance         | text-to-video, image-to-video                                                      | 7–90；开启音频 ×2       | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedence-1-0-pro`      | ByteDance         | text-to-video, image-to-video                                                      | 14                      | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedence-1-0-pro-fast` | ByteDance         | image-to-video                                                                     | 16                      | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `seedence-1-0-lite`     | ByteDance         | text-to-video, image-to-video                                                      | 10–40                   | [Seedance](https://viewmax.studio/zh/docs/api/models/seedance)         |
| `veo-3-1`               | Google            | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 225–285                 | [Veo 3.1](https://viewmax.studio/zh/docs/api/models/veo-3-1)           |
| `veo-3-1-fast`          | Google            | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 30–100                  | [Veo 3.1](https://viewmax.studio/zh/docs/api/models/veo-3-1)           |
| `veo-3-1-lite`          | Google            | text-to-video, image-to-video, frames-to-video, reference-to-video                 | 15–75                   | [Veo 3.1](https://viewmax.studio/zh/docs/api/models/veo-3-1)           |
| `kling-2-6`             | Kling             | text-to-video, image-to-video                                                      | 55–220                  | [Kling 2.6](https://viewmax.studio/zh/docs/api/models/kling-2-6)       |
| `grok-imagine`          | Grok              | text-to-video, image-to-video                                                      | 10–90                   | [Grok Imagine](https://viewmax.studio/zh/docs/api/models/grok-imagine) |
| `grok-imagine-1-5`      | Grok              | text-to-video, image-to-video                                                      | 3 积分/秒（18–90）      | [Grok Imagine](https://viewmax.studio/zh/docs/api/models/grok-imagine) |
| `p-video`               | Pruna AI          | text-to-video, image-to-video                                                      | 20–160                  | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |
| `runway`                | Runway            | text-to-video, image-to-video                                                      | 12–30                   | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |
| `gemini-omni-cheap`     | Google            | text-to-video, image-to-video                                                      | 35                      | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |
| `gemini-omni`           | Google            | text-to-video, image-to-video, video-to-video                                      | 50                      | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |
| `gemini-omni-video`     | Google            | text-to-video, image-to-video, video-to-video                                      | 45–180                  | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |
| `flux-3`                | Black Forest Labs | text-to-video, image-to-video, video-to-video, frames-to-video                     | 16 积分/秒（80–320）    | [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)     |

除标注为按秒计价外，价格均为每次生成消耗的积分。`viewmax-c1` 是 ViewMax 应用的默认模型。

### 不可用的模型

以下模型不会出现在 `GET /api/v1/models` 中，指定它们的请求返回 `400`：

| 模型                       | 响应                                                                                                                                                                 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sora-2`、`sora-2-pro`     | `video model temporarily unavailable: <model>. The provider is not serving this model right now — pick a different model.` 参见 [Sora 2](https://viewmax.studio/zh/docs/api/models/sora-2) |
| `kling-2-6-motion-control` | `This capability is unavailable.`                                                                                                                                    |

## 读取模型目录

```bash
curl "https://viewmax.studio/api/v1/models?type=video"
```

`type` 可取 `video`（默认）、`image` 或 `music`，未知值会返回视频目录。每个视频条目的结构如下（仅展示一个模式）：

```json
{
  "id": "viewmax-c1",
  "label": "ViewMax C1",
  "vendor": "ViewMax",
  "description": "ViewMax C1 text, image, frames, and multi-reference video generation",
  "modes": {
    "text-to-video": {
      "durations": [
        "1s",
        "2s",
        "3s",
        "4s",
        "5s",
        "6s",
        "7s",
        "8s",
        "9s",
        "10s",
        "11s",
        "12s",
        "13s",
        "14s",
        "15s"
      ],
      "resolutions": ["480p", "768P"],
      "aspect_ratios": ["16:9", "9:16"],
      "audio_toggle": false,
      "credits_per_second": { "480p": 2, "768P": 2 },
      "defaults": {
        "resolution": "768P",
        "duration": "5s",
        "aspect_ratio": "16:9"
      }
    }
  },
  "credits_label": "2-30 credits",
  "coming_soon": false
}
```

| 字段                                               | 说明                                                                                       |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `id`                                               | 作为 `model` 发送                                                                          |
| `label`、`vendor`、`description`                   | 展示文本。label 不唯一（有两个模型都叫 "Gemini Omni Flash"）                               |
| `modes`                                            | 仅包含模型支持的模式，以模式 ID 为键                                                       |
| `modes.<mode>.durations`                           | 可用的 `duration` 值。为空表示不要发送 `duration`                                          |
| `modes.<mode>.resolutions`                         | 可用的 `resolution` 值。为空表示不要发送 `resolution`                                      |
| `modes.<mode>.aspect_ratios`                       | 可用的 `aspect_ratio` 值。为空表示不要发送 `aspect_ratio`                                  |
| `modes.<mode>.audio_toggle`                        | 为 `true` 时接受 `audio: true`。`audio: false` 始终可用                                    |
| `modes.<mode>.defaults`                            | 省略 `duration`、`resolution` 或 `aspect_ratio` 时使用并据此计费的值。只包含该模式具备的键 |
| `modes.<mode>.credits`                             | 价格矩阵，结构见下文                                                                       |
| `modes.<mode>.credits_per_second`                  | `{ resolution: rate }`。费用 = `ceil(rate × 时长秒数)`                                     |
| `modes.<mode>.credits_per_second_with_video_input` | 请求包含 `video_urls` 时使用的每秒费率                                                     |
| `modes.<mode>.pricing_note`                        | 音频倍数说明；没有矩阵时为展示标签                                                         |
| `credits_label`                                    | 展示用的范围，不是报价                                                                     |
| `coming_soon`                                      | 已公布但尚不可用的模型为 `true`。目前所有模型均为 `false`                                  |
| `max_prompt_length`                                | 仅当模型限制提示词长度时出现（`minimax-h3`：7000 个字符）                                  |

### 价格矩阵结构

| 结构                                                    | 示例                                                   | 使用者                                                                     |
| ------------------------------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------- |
| `{ resolution: { duration: credits } }`                 | `{ "720p": { "5s": 20, "10s": 40 } }`                  | 多数按次计价的模型。`flux-3` 使用键 `720p`，但不接受 `resolution`          |
| `{ resolution: { "per_generation": credits } }`         | `{ "720p": { "per_generation": 30 } }`                 | Veo 3.1 系列、Gemini Omni 的 video-to-video                                |
| `{ duration: { "without-audio": n, "with-audio": n } }` | `{ "5s": { "without-audio": 55, "with-audio": 110 } }` | `kling-2-6`                                                                |
| `{ quality: { duration: credits } }`                    | `{ "Standard": { "4s": 14 } }`                         | `seedence-1-0-pro`（见其[说明](https://viewmax.studio/zh/docs/api/models/seedance#seedence-10)） |

各模型页面列出了准确价格。目录不包含每个模式可接受的 `image_urls` 或 `video_urls` 数量，这些信息见模型页面。

## 图片和音乐目录

- `?type=image` 条目包含 `id`、`label`、`vendor`、`description`、`modes` 和 `credits_label`。每个模式列出 `aspect_ratios`、`qualities` 和一个价格字段（`credits`、`credits_per_generation`，GPT Image 2.5 为 `credits_by_resolution_and_aspect_ratio`）。参见[图片生成](https://viewmax.studio/zh/docs/api/image-generation)。
- `?type=music` 条目包含 `id`、`label`、`vendor`、`description`、`controls` 和 `credits`。参见[音乐生成](https://viewmax.studio/zh/docs/api/music-generation)。

## 模型页面

- [ViewMax C1 和 Turbo](https://viewmax.studio/zh/docs/api/models/viewmax)
- [MiniMax H3](https://viewmax.studio/zh/docs/api/models/minimax-h3)
- [Seedance 和 Seedence](https://viewmax.studio/zh/docs/api/models/seedance)
- [Veo 3.1](https://viewmax.studio/zh/docs/api/models/veo-3-1)
- [Kling 2.6](https://viewmax.studio/zh/docs/api/models/kling-2-6)
- [Grok Imagine](https://viewmax.studio/zh/docs/api/models/grok-imagine)
- [其他模型](https://viewmax.studio/zh/docs/api/models/other-models)：P-Video、Runway、Gemini Omni、FLUX 3
- [Sora 2](https://viewmax.studio/zh/docs/api/models/sora-2)（暂不可用）
