外观
API 参考
Aivisx Link 同时兼容 Anthropic、OpenAI、Gemini 三套协议，你把客户端或 SDK 的 Base URL 指向本站即可。
API Base URL: https://aivisx.link
鉴权方式: Authorization: Bearer sk-你的KEY
（也支持 x-api-key / x-goog-api-key 请求头）文本与推理
| 方法 | 路径 | 协议 | 说明 |
|---|---|---|---|
| POST | /v1/messages | Anthropic | Messages API，Claude Code 走这个 |
| POST | /v1/messages/count_tokens | Anthropic | 估算 Token 数 |
| POST | /v1/chat/completions | OpenAI | Chat Completions |
| POST | /v1/responses | OpenAI | Responses API，Codex 走这个 |
| POST | /v1/embeddings | OpenAI | 向量化 |
| GET | /v1/models | OpenAI | 当前分组的可用模型列表 |
| GET | /v1beta/models | Gemini | Gemini 原生模型列表 |
| POST | /v1beta/models/{model}:{action} | Gemini | Gemini 原生调用，如 gemini-2.5-pro:generateContent |
图片生成
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/images/generations | 文生图 |
| POST | /v1/images/edits | 图生图 / 编辑 |
| POST | /v1/images/generations/async | 异步文生图（提交任务） |
| POST | /v1/images/edits/async | 异步图生图 |
| GET | /v1/images/tasks/{task_id} | 查询异步任务结果 |
| POST | /v1/images/batches | 批量生图任务 |
| GET | /v1/images/batches | 批量任务列表 |
| GET | /v1/images/batches/{id}/download | 打包下载批量结果 |
详见 图片生成。
视频生成
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/videos /v1/videos/generations | 文生视频 |
| POST | /v1/videos/edits | 视频编辑 |
| POST | /v1/videos/extensions | 视频延长 |
| GET | /v1/videos/{request_id} | 查询任务状态 |
| GET | /v1/videos/{request_id}/content | 下载视频 |
详见 视频生成。
语音
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/tts | 文字转语音 |
| POST | /v1/stt | 语音转文字 |
| POST | /v1/custom-voices | 自定义音色 |
| GET | /v1/realtime | 实时语音（WebSocket） |
详见 语音能力。
账户与计费
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/sub2api/billing | 查询该 Key 的余额与额度信息 |
| GET | /v1/usage | 查询用量 |
搜索类
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/web_search | 联网搜索 |
| POST | /v1/alpha/search | 搜索（Alpha） |
| POST | /v1/x_search | X（Twitter）搜索，仅特定分组可用 |
调用示例
Anthropic 协议
bash
curl https://aivisx.link/v1/messages \
-H "Authorization: Bearer sk-你的KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-7",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "用一句话解释什么是递归"}]
}'OpenAI 协议
bash
curl https://aivisx.link/v1/chat/completions \
-H "Authorization: Bearer sk-你的KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "用一句话解释什么是递归"}]
}'查询余额
bash
curl https://aivisx.link/v1/sub2api/billing \
-H "Authorization: Bearer sk-你的KEY"流式输出
在请求体里加 "stream": true 即可。注意反向代理层已关闭缓冲，长连接不会中断。
错误码
| 返回 | 含义 | 处理方式 |
|---|---|---|
API_KEY_REQUIRED | 没有携带 Key | 检查请求头是否带上 Authorization: Bearer sk-... |
| 401 | Key 无效或已删除 | 到控制台确认 Key 状态 |
| 403 | 分组不允许该操作 | 检查 Key 的分组与所调端点是否匹配 |
| 429 | 触发速率或并发限制 | 降低请求频率，或提高 Key 的并发上限 |
| 余额不足 | 额度耗尽 | 充值，或检查该 Key 的额度上限 |