更简单地接入你的 AI API 服务
这是一份面向用户的接入教程，适合给你的客户直接查看使用。 包含接口地址、Key 使用方式、调用示例、常见问题排查、以及人工客服联系方式。 整体风格更轻、更现代，也更适合中转站业务展示。
接入异常、报错排查、模型选择、使用问题，都可以联系人工客服协助处理。
为什么选择这种接入方式
统一接口、快速迁移、适合现有项目无缝接入。
接入简单
你只需要准备 API Key 和接口地址，即可快速完成调用，不需要复杂学习成本。
兼容性高
支持 OpenAI 风格调用方式，方便已有程序、脚本、项目快速迁移与对接。
人工支持
遇到 401、404、模型错误、余额问题、请求失败等情况，都可直接联系客服处理。
快速接入教程
建议按下面步骤一步一步操作，基本不会出错。
获取你的 API Key
登录平台后台，在 Key 管理或 API 管理页面创建新的密钥。创建成功后请立即复制保存。
填写接口地址 Base URL
将你的程序接口地址填写为平台实际提供的地址，通常格式如下：
https://你的域名/v1请求头中带上鉴权信息
调用时请在请求头中添加 Bearer Token：
Authorization: Bearer 你的_API_Key
Content-Type: application/json先测试模型列表接口
推荐先请求 /v1/models，确认 Key 和地址正常后，再开始正式业务接入。
调用示例
下面这些代码你可以直接复制后修改域名、Key、模型名进行测试。
1. cURL 测试模型列表
curl https://你的域名/v1/models \
-H "Authorization: Bearer 你的_API_Key"2. cURL 对话请求
curl https://你的域名/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的_API_Key" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{
"role": "user",
"content": "你好，请做一个简短的自我介绍"
}
],
"temperature": 0.7
}'3. Python 请求示例
import requests
url = "https://你的域名/v1/chat/completions"
headers = {
"Authorization": "Bearer 你的_API_Key",
"Content-Type": "application/json"
}
data = {
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "写一句欢迎语"}
],
"temperature": 0.7
}
resp = requests.post(url, headers=headers, json=data, timeout=60)
print(resp.status_code)
print(resp.text)4. Node.js 请求示例
const url = "https://你的域名/v1/chat/completions";
async function main() {
const resp = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer 你的_API_Key"
},
body: JSON.stringify({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "请输出一句欢迎文案" }
],
temperature: 0.7
})
});
const text = await resp.text();
console.log(resp.status, text);
}
main().catch(console.error);5. OpenAI SDK 兼容示例（Python）
from openai import OpenAI
client = OpenAI(
api_key="你的_API_Key",
base_url="https://你的域名/v1"
)
completion = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "你好"}
]
)
print(completion)模型与参数说明
不同模型名称以你后台实际显示为准，下面是常见参数含义。
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | 模型名称，请按平台后台提供的模型名填写。 |
| messages | array | 对话消息数组，通常由 system、user、assistant 组成。 |
| temperature | number | 控制输出随机性，一般建议 0.2 ~ 0.8。 |
| stream | boolean | 是否开启流式输出，适合聊天场景逐步返回内容。 |
| max_tokens | number | 限制输出长度，防止回复过长。 |
常见问题
下面是用户接入过程中最常遇到的问题。
Q1：401 Unauthorized 是什么原因？
通常是 API Key 错误、Bearer 格式不对、Key 已失效、或者请求头没有正确带上鉴权信息。
Q2：404 Not Found 怎么处理？
通常是接口地址错误、路径错误，或者遗漏了 /v1。请核对你的 Base URL 与接口路径。
Q3：为什么我有 Key 但是还是请求失败？
除了 Key 本身，也要检查模型名、域名、余额、权限、请求头格式、程序中的 JSON 结构是否正确。
Q4：建议先测试哪个接口？
建议先调用 /v1/models，它最适合用来验证鉴权与接口地址是否正常。
Q5：如果还是调不通怎么办？
把你的报错截图、调用返回内容、模型名、调用时间发给客服，会更方便快速定位问题。
联系客服
接入异常、报错排查、模型问题、使用疑问，都可以直接联系人工客服。