开放 API 支持哪些接口?怎么对接?
开放 API 支持哪些接口?怎么对接? 关键参数
| 接口规范 | OpenAI 兼容 RESTful |
|---|---|
| 路径前缀 | /v1 |
| 鉴权方式 | Authorization: Bearer 密钥 |
| 对接步骤 | 建密钥 → 换 base_url → 指定 model → 发起请求 |
支持哪些接口
平台提供与 OpenAI 兼容的 RESTful 接口,统一通过同一个网关地址调用,可按需使用:
- 对话补全:文本生成、多轮对话
- 图像处理:文生图、图像编辑
- 视频生成:文生视频、图生视频(异步任务)
- 语音:语音识别、语音合成
- 智能体:可调用的智能体工作流
- 向量与嵌入:文本向量化
所有接口均使用 HTTPS,鉴权方式为请求头 Authorization: Bearer 你的密钥。
怎么对接(四步)
- 在控制台创建 API 密钥(见《第一次用开放 API》)。
- 把请求地址的 base_url 换成平台网关地址。
- 在请求体里指定模型代号(model 字段)。
- 发起请求并处理返回。
最小可运行示例
下面以对话接口为例,实际字段以官方文档为准:
POST {网关地址}/v1/chat/completions
Authorization: Bearer 你的密钥
Content-Type: application/json
{
"model": "模型代号",
"messages": [{ "role": "user", "content": "你好" }]
}
注意事项
- 所有路径均以 /v1 开头,便于直接复用 OpenAI 生态的 SDK。
- 生产环境务必保管好密钥,不要在前端代码里明文写入。
- 具体端点、参数与限额以灵境AI官方文档为准。
本文为帮助中心初稿,端点细节以官方文档为准。
常见问题
平台开放 API 支持哪些接口?
覆盖对话补全、图像生成与编辑、视频生成(异步任务)、语音识别与合成、智能体工作流、文本向量化等,全部兼容 OpenAI 接口规范,统一网关调用。
对接需要几步?
四步:创建 API 密钥 → 把 base_url 换成平台网关地址 → 请求体指定 model 模型代号 → 发起请求并处理返回。
接口路径有什么规律?
所有路径均以 /v1 开头,例如 /v1/chat/completions,可直接复用 OpenAI 生态的 SDK。
密钥怎么传?
放在请求头 Authorization: Bearer 你的密钥 中;生产环境务必不要在前端代码里明文保存密钥。
相关阅读
怎么让 AI 调我自己的函数 / 工具(tools 工具调用怎么写)
通过 tools 字段声明函数 schema,模型返回 tool_calls 后由你在本地执行,再把结果回传给模型继续推理。调接口怎么把图片发给 AI 看?多模态请求怎么写、图片传链接还是文件
多模态请求用 content 数组把文本与 image_url 一起传;图片可传公网可访问的链接,或传 base64 data URI,二者各有取舍。调接口报错怎么办?鉴权失败、频率超限、余额不足逐个排查
按错误类型排查:401 鉴权、403 权限、429 限频、402/余额不足、4xx 参数、5xx 服务端,本文给出逐项对策。API 密钥怎么创建?用量和额度在哪看?
在控制台「API 密钥」创建密钥;用量与额度在同页或「用量」页查看,包含调用次数、tokens 消耗与费用。相关平台
关于大模型的选型、调用与落地实践,你还可以访问以下平台:
- cloud-lab.cn —— 灵境AI 模型百科:大模型选型、对比评测与用户手册,AI Model Hub 官方知识站。
- cloud-token.ai(AI Model Hub 国内版) —— 聚合 500+ 前沿大模型,统一 OpenAI 兼容 API,免费试用、按量计费。
- cloud-ai.link(AI Model Hub 国际版) —— 面向全球用户,英文界面,统一 OpenAI 兼容 API,即开即用。