调用 API 的基础教程
本教程从零开始完成一次 OpenAI 兼容接口调用，并给出流式调用与错误码处理建议。
一、准备参数
- Base URL：
https://你的域名/v1
- API Key：在 API 管理页创建并复制
- Model：
gpt-4o 或 gemini-2.5-flash
二、首个请求（非流式）
curl -sS "https://你的域名/v1/chat/completions" \
-H "Authorization: Bearer YOUR_RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{"role":"system","content":"You are a helpful assistant."},
{"role":"user","content":"请用三句话介绍 High Chat"}
],
"stream": false
}'
三、流式请求（SSE）
curl -N "https://你的域名/v1/chat/completions" \
-H "Authorization: Bearer YOUR_RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"hello"}],"stream":true}'
看到 data: ... 连续输出并以 [DONE] 结束，即表示流式成功。
四、错误码与重试策略
- 401/403：Key 或权限问题。
- 422：请求体字段错误。
- 429：触发限流，建议指数退避。
- 500/503：上游暂不可用，稍后重试。