指北猫
菜单
返回 API 产品首页
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。