深色模式
接口总览
Moniker 同时兼容 OpenAI、Anthropic(Claude)、Gemini 三种原生协议。你现有的代码和 SDK 一般只需要改 Base URL 和 API Key 两处。
Base URL
| 协议 | Base URL |
|---|---|
| OpenAI 兼容 | https://aimoniker.top/v1 |
| Anthropic 原生 | https://aimoniker.top |
| Gemini 原生 | https://aimoniker.top |
TIP
哪种工具该填哪个地址、哪些模型支持哪种协议,见 Base URL 与兼容性。
鉴权
所有接口都使用控制台创建的 sk- 密钥,以下任一种请求头均可:
http
Authorization: Bearer sk-xxxxhttp
x-api-key: sk-xxxxGemini 原生接口也支持 x-goog-api-key: sk-xxxx 或 URL 参数 ?key=sk-xxxx。
支持的接口
| 能力 | 方法与路径 | 协议 |
|---|---|---|
| 对话 | POST /v1/chat/completions | OpenAI |
| Responses | POST /v1/responses | OpenAI(Codex 使用) |
| Claude 消息 | POST /v1/messages | Anthropic |
| Gemini 生成 | POST /v1beta/models/{model}:generateContent | Gemini |
| Gemini 流式 | POST /v1beta/models/{model}:streamGenerateContent | Gemini |
| 模型列表 | GET /v1/models | OpenAI |
| 向量 | POST /v1/embeddings | OpenAI |
| 图片生成 | POST /v1/images/generations | OpenAI |
| 图片编辑 | POST /v1/images/edits | OpenAI |
| 语音 | POST /v1/audio/speech、/v1/audio/transcriptions | OpenAI |
| 视频生成 | POST /v1/video/generations | 统一视频接口 |
| 视频查询 | GET /v1/video/generations/{task_id} | 统一视频接口 |
具体可用的模型取决于密钥所在分组,可用 GET /v1/models 查询:
bash
curl https://aimoniker.top/v1/models -H "Authorization: Bearer sk-xxxx"错误格式
出错时返回对应 HTTP 状态码和 JSON 错误体,message 为中文说明。错误码、可否重试与重试策略见 错误处理;长输出请先阅读 流式输出与超时。
