核心能力
| 能力 | 说明 |
|---|---|
| 模型 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 调用
- 在模型服务页面找到目标 API 模型。
- 在
API 参考文档中获取endpoint与请求体格式。 - 在请求头中带上
Authorization: Bearer <token>（token 从个人中心获取）。 - POST 提交请求，返回
requestId用于后续查询。
异步任务
- 提交任务后保留返回的
requestId。 - 通过异步查询接口轮询任务状态。
- 任务完成后获取结果 URL。
WebHook 回调
- 在请求参数中设置
webhook_url。 - 任务完成后平台会向该 URL POST 回调结果。
- 服务端校验签名后落库结果。
命令行工具
- 安装 BizyAir CLI 工具。
- 通过
bizyair login登录账号。 - 使用
bizyair run <endpoint> --input <file>调用模型。 - 使用
bizyair task get <requestId>查询任务状态。
Note: 详细 API 字段、错误码与 CLI 命令请参考 docs.bizyair.cn 的API 参考、返回码说明、命令行工具章节。