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

# Doubao 概览

> 面向普通 API 调用者的 Doubao / VolcArk 能力说明

本页面面向 **普通 API 使用者（非管理员）**，帮助你快速搞清楚三件事：

1. Doubao / VolcArk 能做什么；
2. 你需要记住哪些模型名；
3. 想要实现某个能力，该去看哪一篇文档、调用哪个接口。

你可以把 Doubao / VolcArk 理解为：

* 由 **火山引擎方舟（VolcArk）** 提供的一组大模型与多模态能力；
* 在 HingNet AI 中，通过统一的 **OpenAI 风格 API** 暴露出来（`/v1/chat/completions`、`/v1/responses`、`/v1/images/generations`、`/v1/videos` 等）；
* 包含豆包自研模型，以及通过方舟聚合的 DeepSeek / Kimi 等模型。

你只需要会用 HingNet AI 的 API Key 和模型名，不需要管理渠道、密钥和控制台配置。

***

## 一、快速上手：Doubao 能力一览

在文档左侧的 **“Doubao” Tab** 下，你可以找到几类能力：

* **文本 & 多模态对话**
  * 使用 `/v1/chat/completions` 或 `/v1/responses`；
  * 代表模型：
    * 豆包：`doubao-seed-1.8`、`doubao-seed-1.6`、`doubao-seed-1.6-lite`、`doubao-seed-1.6-flash`、`doubao-seed-1.6-vision`（兼容别名：`doubao-seed-1.6-thinking`）
    * DeepSeek：`deepseek-v3.2`、`deepseek-v3.1`、`deepseek-v3`、`deepseek-r1-ark`
    * Kimi：`kimi-k2`
    * GLM：`glm-4.7`（需管理员在 VolcArk 渠道启用）
  * 详见：`doubao/chat`

* **图片生成（文生图 / 图生图 / 组图）**
  * 使用 `/v1/images/generations`；
  * 代表模型：`doubao-seedream-4.0`、`doubao-seedream-3.0-t2i`、`doubao-seededit-3.0-i2i`
  * 详见：`doubao/image`、`doubao/image-seedream-4.0-n`

* **视频生成（文生视频 / 图生视频）**
  * 两种调用方式：
    * VolcArk 原生接口：`/volcark/api/v3/contents/generations/tasks`（更贴近官方文档）
    * OpenAI 风格接口：`/v1/videos`（与 OpenAI Sora/Veo 一致）
  * 代表模型：`doubao-seedance-1-0-pro`、`doubao-seedance-1-0-pro-fast`、`doubao-seedance-1-0-lite-t2v`、`doubao-seedance-1-0-lite-i2v`
  * 详见：`doubao/video`、`doubao/video-openai`

* **语音合成（TTS）**
  * 使用 Volcengine OpenSpeech 接口透传：`/volcark/openspeech/...`
  * 支持 V1 / V3 HTTP 与 WebSocket；
  * 详见：`doubao/volcark-tts`

可以简单理解为：

* “对话 / Agent / 工具调用” → 看 `doubao/chat`；
* “画图 / 图生图 / 组图” → 看 `doubao/image`；
* “文生视频 / 图生视频” → 看 `doubao/video` / `doubao/video-openai`；
* “TTS 语音合成” → 看 `doubao/volcark-tts`。

***

## 二、模型名怎么填？（API 模型名）

作为 API 调用者，你只需要记住 **API 模型名**，例如：

* Doubao 文本模型：
  * `doubao-seed-1.8`
  * `doubao-seed-1.6`
  * `doubao-seed-1.6-lite`
  * `doubao-seed-1.6-flash`
  * `doubao-seed-1.6-vision`
  * `doubao-seed-1.6-thinking`（兼容别名）
* Doubao 辅助模型：
  * `doubao-seed-code`
  * `doubao-seed-translation`
* 聚合模型（通过火山方舟）：
  * `deepseek-v3.2`
  * `deepseek-v3.1`
  * `deepseek-v3`
  * `deepseek-r1-ark`
  * `kimi-k2`
  * `glm-4.7`（需管理员在 VolcArk 渠道启用）

在 HingNet AI 内部，这些 API 模型名会自动映射为真实的上游版本 ID（带日期后缀的长名字），例如：

| API 模型名                    | 后台实际模型 ID（示例，仅供理解）                                |
| -------------------------- | ------------------------------------------------- |
| `doubao-seed-1.8`          | `doubao-seed-1-8-251228`                          |
| `doubao-seed-1.6`          | `doubao-seed-1-6-251015`                          |
| `doubao-seed-1.6-lite`     | `doubao-seed-1-6-lite-251015`                     |
| `doubao-seed-1.6-flash`    | `doubao-seed-1-6-flash-250828`                    |
| `doubao-seed-1.6-vision`   | `doubao-seed-1-6-vision-250815`                   |
| `doubao-seed-1.6-thinking` | `doubao-seed-1-8-251228`                          |
| `doubao-seed-code`         | `doubao-seed-code-preview-251028`                 |
| `doubao-seed-translation`  | `doubao-seed-translation-250915`                  |
| `deepseek-v3.2`            | `deepseek-v3-2-251201`                            |
| `deepseek-v3.1`            | `deepseek-v3-1-terminus` / `deepseek-v3-1-250821` |
| `deepseek-v3`              | `deepseek-v3-250324`                              |
| `deepseek-r1-ark`          | `deepseek-r1-250528`                              |
| `glm-4.7`                  | `glm-4-7-251222`                                  |
| `kimi-k2`                  | `kimi-k2-thinking-251104`                         |

> 对你来说最重要的一点：
> **只在请求体里填 API 模型名，其他的都交给平台处理。**

如果你在请求时遇到：

> `InvalidEndpointOrModel.NotFound`\
> `The model or endpoint xxx does not exist or you do not have access to it.`

可以优先检查：

* 是否手误输入了模型名，例如 `doubau-seed-1.6`；
* 是否复制了带日期后缀的内部 ID（如 `doubao-seed-1-6-...`），而不是文档中的 API 名。

仍然不确定时，建议：

* 到 HingNet AI 控制台的「模型价格」页面确认是否能看到该模型名；
* 或直接联系管理员确认当前账号是否有权限使用对应模型。

***

## 三、如何选 Doubao / DeepSeek / Kimi 模型？

如果你只想“先跑通再优化”，可以直接按下面的建议来选：

* **通用中文/英文对话助手**
  * 首选：`doubao-seed-1.8`
  * 稳定兼容：`doubao-seed-1.6`
  * 低成本版本：`doubao-seed-1.6-lite`
  * 对响应速度敏感：`doubao-seed-1.6-flash`

* **需要更强的思考与推理能力**
  * Doubao 深度思考：`doubao-seed-1.8`（`doubao-seed-1.6-thinking` 为兼容别名）
  * DeepSeek 思考增强：`deepseek-v3.2`、`deepseek-v3.1`、`deepseek-r1-ark`
  * Kimi 思维链：`kimi-k2`

* **需要代码能力 / 工程场景**
  * 首选：`doubao-seed-code`
  * 也可以尝试：`deepseek-v3.1` / `deepseek-v3`（开源社区生态更丰富）

* **翻译与多语种写作**
  * 首选：`doubao-seed-translation`
  * 对上下文理解要求高时，可使用 `doubao-seed-1.6` 作为通用翻译/润色模型。

* **需要看图 / 图文问答**
  * 使用：`doubao-seed-1.6-vision`
  * 调用方式与 OpenAI Vision 模型一致，在 `messages.content` 中混合文字与 `image_url`。

更详细的请求示例与字段说明，请参考：

* 文本 / 多模态对话：`doubao/chat`
* 图片生成：`doubao/image`
* 视频生成：`doubao/video`、`doubao/video-openai`
* 语音合成：`doubao/volcark-tts`

***

## 四、你不需要关心的事情

作为普通 API 调用者，你 **不需要**：

* 在火山方舟控制台里开通或配置模型；
* 管理 VolcArk 的 BaseURL、密钥、签名算法；
* 决定渠道如何路由、如何做负载均衡、如何定价。

这些工作都由平台和管理员负责。\
你只需要：

1. 在 HingNet AI 控制台获取一个 API Key（`oh-xxxxxxxx`）；
2. 在文档中选好模型名（例如 `doubao-seed-1.6`）；
3. 按 OpenAI 的方式调用 `/v1/chat/completions`、`/v1/responses`、`/v1/images/generations` 或 `/v1/videos` 即可。

其它诸如：模型版本升级、价格变更、上游 ID 更新、渠道切换等，都在后台自动完成，不影响你的调用方式。