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

# 模型服务

> 通过一个 API 接口可调用多种模态的模型，可直接投入生产环境

模型服务是把平台上的模型能力以 HTTP API 形式提供给外部应用调用的入口，面向开发者与集成场景。它把模型能力转化为可编程接口，支持异步任务、WebHook 回调、文件上传等 HTTP API 操作，并提供命令行工具便于批量管理。你可以把它理解为「ComfyUI 节点能力 → HTTPS API → 业务系统」的服务化层。

### 核心能力

| 能力         | 说明                      |
| ---------- | ----------------------- |
| 模型 API 调用  | 通过 HTTPS POST 调用平台模型能力  |
| 异步任务       | 长时间生成任务通过异步接口查询结果       |
| WebHook 回调 | 任务完成后通过 WebHook 主动通知调用方 |
| 文件上传       | 上传图片 / 模型等文件作为 API 输入   |
| 命令行工具      | 提供 CLI 命令行工具进行批量管理与调用   |
| 标签筛选       | 通过业务标签快速定位模型            |
| 厂商筛选       | 按厂商（谷歌/字节/阿里/硅基流动…）筛选   |
| 自部署标记      | BizyAir 优化部署的开源模型       |

### 适用场景

* **后端集成**：把 BizyAir 模型能力接入自家产品后端
* **Agent 调用**：让 AI Agent 通过 API 调用模型产出图/视频
* **批量处理**：通过 CLI 或脚本批量提交生成任务
* **服务化变现**：把模型能力封装成对外 SaaS 服务

### 能力类别

模型服务的 API 按「输入→输出」维度划分为 16 个能力类别。

#### 类别分布

| 类别                       | 类别                        | 类别                   | 类别                  |
| ------------------------ | ------------------------- | -------------------- | ------------------- |
| Text to Video 文生视频       | Text to Image 文生图         | Image to Image 图生图   | Image to Video 图生视频 |
| FLF to Video 首尾帧生视频      | Video Edit 视频编辑           | Audio to Audio 音生音频  | Text to Speech 文生语音 |
| Reference to Video 参考生视频 | Large Language Models 大模型 | Vision 视觉理解          | Text to Audio 文生音频  |
| Video Extend 视频延长        | Image to 3D 图生 3D         | Speech to Text 语音转文本 | Text to Lyrics 文生歌词 |

### 厂商分布

更多厂商正在接入中。

| 厂商     | 厂商          | 厂商      | 厂商                |
| ------ | ----------- | ------- | ----------------- |
| 谷歌     | 字节          | 阿里      | 硅基流动（SiliconFlow） |
| 昆仑万维   | 生数科技        | 快手 / 可灵 | XAI / grok        |
| OpenAI | MiniMax（海螺） | 黑森林     | 即梦                |

> **Note:** `owner=Self` 为硅基流动自部署模型，`owner=Third` 为第三方渠道版，计费单价可能不同。

### API 模型字段说明

每个 API 模型都包含以下核心字段：

| 字段            | 说明                                         |
| ------------- | ------------------------------------------ |
| display\_name | 模型展示名                                      |
| description   | 模型能力描述                                     |
| category      | 能力类别（如 `Text to Image`、`Image to Video` 等） |
| model\_name   | 模型内部名（API 调用时使用）                           |
| endpoint      | API 调用端点路径                                 |
| tags          | 业务标签数组                                     |
| status        | 状态（`normal` / `gray` 灰度）                   |
| gray          | 是否灰度发布                                     |
| new\_tag      | 是否为新上线                                     |
| owner         | 来源（`Self` 自部署 / `Third` 第三方）               |
| manufacturer  | 提供厂商                                       |

### 调用方式

#### 直接 HTTP 调用

1. 在模型服务页面找到目标 API 模型。
2. 在 `API 参考` 文档中获取 `endpoint` 与请求体格式。
3. 在请求头中带上 `Authorization: Bearer <token>`（token 从个人中心获取）。
4. POST 提交请求，返回 `requestId` 用于后续查询。

#### 异步任务

1. 提交任务后保留返回的 `requestId`。
2. 通过异步查询接口轮询任务状态。
3. 任务完成后获取结果 URL。

#### WebHook 回调

1. 在请求参数中设置 `webhook_url`。
2. 任务完成后平台会向该 URL POST 回调结果。
3. 服务端校验签名后落库结果。

#### 命令行工具

1. 安装 BizyAir CLI 工具。
2. 通过 `bizyair login` 登录账号。
3. 使用 `bizyair run <endpoint> --input <file>` 调用模型。
4. 使用 `bizyair task get <requestId>` 查询任务状态。

> **Note:** 详细 API 字段、错误码与 CLI 命令请参考 docs.bizyair.cn 的 `API 参考`、`返回码说明`、`命令行工具` 章节。

### 计费与价格

模型定价请参考[节点价格参考](节点价格参考)