API DOCUMENTATION
快速接入与接口参考
配置您的 API Key 和统一接口地址,即可通过 OpenAI 兼容格式访问模型服务。以下提供基本接入步骤、客户端配置和接口参考。
01 / 接入配置
API Base URL
https://api.zhibeimao.com/v1选择并复制接口地址备选:https://api.chatgpt5x.com/v1
Authentication
Authorization: Bearer YOUR_API_KEY不要将真实 Key 提交到公开代码仓库或浏览器前端。
02 / 对话接口示例
以下示例采用 gpt-5.6-terra。调用前请通过模型列表接口确认当前 Key 可用的模型 ID。
cURL · OpenAI 兼容对话代码示例
curl -X POST 'https://api.zhibeimao.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"你好,请只回复 OK"}]}'Python · OpenAI SDK代码示例
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["AI_API_KEY"],
base_url="https://api.zhibeimao.com/v1"
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "你好,请只回复 OK"}]
)
print(response.choices[0].message.content)先安装 openai SDK,并通过服务器环境变量 AI_API_KEY 保存 Key。
03 / AI 客户端快速配置
Chatbox、Cherry Studio 等支持自定义 OpenAI 兼容服务的客户端,可参考以下字段配置。不同版本的菜单名称可能略有差异。
服务商类型OpenAI Compatible / 自定义 OpenAI
Base URLhttps://api.zhibeimao.com/v1
API Key您的 API Key
模型 ID从 /v1/models 查询后填写
04 / 查询模型
请求 GET /v1/models 并携带 API Key,可获得当前可用的模型 ID。请使用返回的模型 ID 进行调用。
curl 'https://api.zhibeimao.com/v1/models' -H 'Authorization: Bearer YOUR_API_KEY'05 / 接口目录
以下列出基础接口,使用时需提供 API Key。其他协议和多模态能力因模型而异。
GET
/v1/models获取当前 API Key 可用的模型列表POST
/v1/chat/completions按 OpenAI 兼容格式发起模型对话更多接口路径参考查看接口
POST
/v1/responsesResponses 格式对话POST
/v1/messagesMessages 格式对话POST
/v1beta/models/{model}:generateContentGemini 模型内容生成POST
/v1/embeddings文本向量生成POST
/v1/images/generations图像生成POST
/v1/images/edits图像编辑POST
/v1/videos部分视频模型任务创建GET
/v1/videos/{task_id}部分视频模型任务查询不同模型支持的接口格式与功能范围可能不同。请根据所选模型的能力说明和账户权限使用相应接口。
接入注意事项
API Key 余额及可用额度可通过 余额查询页面 查看。不同模型的接口格式及可用能力,请以对应模型说明为准。
如遇鉴权错误,请检查 API Key、请求头及 Base URL;如提示模型不可用,请查询 /v1/models 确认正确的模型 ID。