文档API 参考
API 参考
MoleAPI API 参考与接口总览
概述
MoleAPI 提供完整的 RESTful API 接口，分为 AI 模型接口 和 管理接口 两大类，可用于模型调用、令牌管理与网关后台操作。
在线调试
您可以访问 Apifox 操练场 在线测试和调试 API 接口，或直接浏览下方的 API 文档。
接入基础
Base URL
| 场景 | Base URL | 说明 |
|---|---|---|
| OpenAI 兼容调用 | https://api.moleapi.com/v1 | 适合 SDK、自建项目和大多数第三方客户端 |
| Claude Code | https://api.moleapi.com | 适合通过 Anthropic 环境变量接入 Claude Code |
| 在线调试 | https://apifox.moleapi.com/ | 适合在浏览器里查看和测试接口 |
认证方式
AI 模型接口通常使用 Bearer Token：
Authorization: Bearer sk-your-api-key如果工具提供的是图形化配置页，一般把同一个 Key 填到 API Key、Token 或 密钥 字段即可。
常用端点
| 端点 | 方法 | 用途 |
|---|---|---|
/v1/chat/completions | POST | 对话补全 |
/v1/responses | POST | Responses 格式调用，具体支持以模型能力为准 |
/v1/embeddings | POST | 文本向量 |
/v1/models | GET | 查询可用模型 |
/v1/images/generations | POST | 图像生成 |
常见状态码
| 状态码 | 说明 | 优先检查 |
|---|---|---|
400 | 请求参数错误 | JSON 结构、字段类型、模型参数 |
401 | 认证失败 | API Key 是否正确或过期 |
403 | 权限不足 | 模型权限、分组、IP 白名单 |
404 | 路径错误 | Base URL 是否漏了 /v1 |
429 | 限流或额度问题 | 余额、并发、Key 限额 |
500 | 服务端异常 | 重试并保留请求信息 |
AI 模型接口
AI 模型接口提供各种 AI 能力的调用，兼容 OpenAI API 格式。
模型列表
获取可用的模型列表。
聊天
对话补全接口。
补全
传统文本补全接口。
嵌入
文本嵌入向量生成接口。
重排序
文档重排序接口。
审查
内容安全审核接口。
音频
语音识别和语音合成接口。
实时语音
实时音频流接口。
图像
AI图像生成接口。
视频
AI视频生成接口。
未实现
占位接口，暂未实现。
管理接口
管理接口用于系统配置、用户管理、业务管理等后台操作。
这篇文档对您有帮助吗？
最后更新于