1. 快速开始 最先要看
开始使用
终端模板
命令说明
常见检查项
curl 调用
curl -X POST https://apicoud.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4",
"messages": [
{"role": "user", "content": "你好,帮我写一段介绍文案"}
]
}'
接口返回模式
流式返回
{
"model": "gpt-4",
"stream": true,
"messages": [
{"role": "user", "content": "帮我写一段产品介绍"}
]
}
Python 调用
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://apicoud.com/v1"
)
resp = client.chat.completions.create(
model="gpt-4",
messages=[
{"role": "user", "content": "你好,帮我写一段介绍文案"}
]
)
print(resp.choices[0].message.content)
Node.js 调用
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://apicoud.com/v1"
});
const resp = await client.chat.completions.create({
model: "gpt-4",
messages: [
{ role: "user", content: "你好,帮我写一段介绍文案" }
]
});
console.log(resp.choices[0].message.content);
2. 常见软件怎么填 配置方式
Codex / 类 Codex 工具
VS Code / IDE 插件
桌面聊天客户端
自动化 / Agent 工具
API Key
Base URL
Model
Provider
OpenAI-compatible
3. 测试工具怎么配 先测通路
Postman / Apifox / Insomnia
最常填的几个位置
{
"base_url": "https://apicoud.com/v1",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
"body": {
"model": "gpt-4",
"messages": [
{"role": "user", "content": "你好"}
],
"stream": false
}
}
建议先测什么
如果没通
4. 模型与能力 可选模型
通用对话
适合作为基础接入模型。
长文本与分析
适合处理更长的上下文内容。
多模态
支持图片输入的多模态模型。
模型名
适合场景
是否支持多模态
上下文长度
5. 账户与计费 余额与用量
账单信息
费用说明
| 字段 | 含义 |
|---|---|
prompt_tokens |
输入内容消耗的 token |
completion_tokens |
模型输出消耗的 token |
total_tokens |
总消耗 token |
{
"usage": {
"prompt_tokens": 12,
"completion_tokens": 48,
"total_tokens": 60
},
"billing": {
"estimated_cost": "0.0023"
}
}
6. 错误码与排错 常见问题
| 错误码 | 说明 | 处理方式 |
|---|---|---|
400 |
参数格式不对或缺少必填项 | 检查请求体里的字段名和内容格式 |
401 |
API Key 无效或未携带 | 检查 Authorization 是否正确 |
403 |
没有权限访问该模型或功能 | 确认账号权限和模型开通情况 |
429 |
请求过快,触发限流 | 降低频率,稍后重试 |
500 |
上游服务或网关异常 | 查看状态页,必要时联系支持 |
502 |
上游返回异常 | 稍后重试,通常是上游临时波动 |
503 |
服务暂时不可用 | 等待恢复后再试 |
504 |
请求超时 | 稍后重试,必要时调整超时设置 |
7. 公告与客服 最新消息
公告
客服入口
接口调用 调用说明
| 字段 / 英文 | 中文意思 |
|---|---|
POST /v1/chat/completions |
标准对话接口,意思是“发一句话,模型回一句话”。 |
model |
要调用的模型名称。 |
messages |
聊天内容,也就是发给模型的话。 |
temperature |
控制回答风格,数值越高越灵活,数值越低越稳定。 |