接口总览¶

🚀 快速开始¶

兆投算力提供 OpenAI 兼容接口，你只需要：

在控制台创建 API Key（Token）
设置 Base URL 并携带 Authorization: Bearer <API_KEY>
发送一次最小请求验证连通

如何获取 API Key（Token）

控制台路径：API 令牌

控制台：API 令牌 →

Base URL

生产环境建议使用 HTTPS：

https://zhaotouai.com

模型接口鉴权（/v1/*）

文档中的 $ZHAOTOU_API_KEY 就是你在控制台创建的 API Key（Token）。

最小调用示例（Chat Completions）¶

curl https://zhaotouai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZHAOTOU_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "messages": [{"role": "user", "content": "你好"}]
  }'

测试模型列表（/v1/models）¶

curl https://zhaotouai.com/v1/models \
  -H "Authorization: Bearer $ZHAOTOU_API_KEY"

🔁 从 OpenAI 迁移¶

如果你已经在用 OpenAI SDK/第三方客户端（Cursor、ChatBox、Cherry Studio 等），通常只需要：

将 base_url / api_base 改为 https://zhaotouai.com/v1
api_key 改为你在兆投算力控制台创建的 API Key（Token）

🔐 鉴权说明（务必区分两类接口）¶

模型接口（/v1/*）：用于模型调用，使用 API Key（Token）（即 Authorization: Bearer <API_KEY>）
前端接口（/api/*）：用于 Web 控制台功能，使用 AccessToken（用户/管理员/Root）

详细说明见：鉴权体系说明 →

❗ 常见错误¶

401 Unauthorized：API Key/AccessToken 无效或未携带 Authorization
429 Too Many Requests：触发限流（请降低并发/请求频率，或联系管理员调整策略）
5xx：上游模型或网络波动，建议重试

💫 模型接口¶

聊天（Chat）

支持多种主流聊天模型格式：

OpenAI Chat → OpenAI Responses → Anthropic Chat → Deepseek Chat → Google Chat →
嵌入（Embeddings）

文本向量嵌入服务：

OpenAI Embeddings →
重排序（Rerank）

搜索结果重排序服务：

Jina AI Rerank → Cohere Rerank → Xinference Rerank →
实时对话（Realtime）

支持流式实时对话：

OpenAI Realtime →
图像（Image）

AI 图像生成服务：

OpenAI Image → Midjourney Proxy →
音频（Audio）

语音相关服务：

OpenAI Audio →
音乐（Music）

AI 音乐生成服务：

Suno API →
视频（Video）

AI 视频生成和查询服务：

生成视频 → 查询视频 →

🖥️ 前端接口¶

API 参考文档

系统采用四级鉴权机制：公开、用户、管理员、Root

接口前缀统一为 http(s)://<your-domain>

( 生产环境应使用 HTTPS 以保证认证令牌。 HTTP 仅建议用于开发环境。 )

鉴权体系说明 → 获取可用模型列表 → 接口模块使用指南 →

📖 接口说明¶

接口类型

兆投算力提供两大类接口：

模型接口：用于 AI 模型的调用，支持多种主流模型格式
前端接口：用于支持 Web 界面的功能调用，提供完整的前端功能支持

功能支持标识

在接口文档中，我们使用以下图标来标识功能支持状态：

✅ 已支持：该功能已经完全实现并可以使用
🟡 部分支持：功能已可用，但存在限制或仅提供部分能力
❌ 未支持：该功能正在开发中或计划开发

快速开始

浏览上方卡片选择需要使用的接口
点击对应卡片的"查看详情"了解具体用法
按照文档说明进行接口调用