---
title: API 接入总览
description: 统一入口与鉴权方式，按分组和模型选择正确的协议。
---

API 基础地址为 `https://sub.vcnovb.cn`。在[控制台](https://sub.vcnovb.cn/keys)创建 API Key，并通过请求头传入：

```http
Authorization: Bearer YOUR_VC_API_KEY
Content-Type: application/json
```

## 常用接口

| 能力 | 方法与路径 | 说明 |
| --- | --- | --- |
| [模型列表](/api/models) | `GET /v1/models` | 当前 Key 的模型目录 |
| [聊天补全](/api/chat) | `POST /v1/chat/completions` | OpenAI 兼容消息格式 |
| [Responses](/api/responses) | `POST /v1/responses` | Responses 格式 |
| [Claude Messages](/api/messages) | `POST /v1/messages` | Anthropic 兼容消息格式 |
| [Gemini 原生](/api/gemini) | `POST /v1beta/models/{model}:generateContent` | Gemini contents 格式 |
| [图片生成 / 编辑](/api/images) | `POST /v1/images/generations`、`POST /v1/images/edits` | 需要图片模型及权限 |
| [图片异步任务](/api/image-tasks) | `POST /v1/images/generations/async` | 创建异步图片任务 |
| [视频生成](/api/videos) | `POST /v1/videos` | 视频分组的异步任务入口 |
| [视频查询](/api/video-tasks) | `GET /v1/videos/{id}` | 使用创建任务的 Key 查询 |

选择与模型匹配的接口，并将 API Key 绑定到对应分组。可用模型可通过[模型列表](/api/models)查询。

## 调用说明

- cURL 示例使用 Bash 语法，提前设置 `VC_API_KEY` 环境变量。
- 将示例中的模型名、任务 ID 和素材 URL 替换为本次请求使用的值。
- 流式请求采用 SSE，客户端需保持连接并逐条读取事件。
- 同步图片接口直接返回结果；异步图片和视频接口先返回任务信息，再通过查询接口获取结果。

<Warning>不要在浏览器前端直接嵌入 Key。将 API 调用放在自己的服务端，并为不同应用配置独立密钥和额度。</Warning>

出错后先检查 HTTP 状态与错误正文，详见[故障排查](/help/troubleshooting)。