快速开始

用最少的步骤发起第一条请求，确认服务地址、密钥和返回结构都符合预期。

接入前准备

• 在主站“密钥管理”中生成一把新的 API Key
• 确认服务端请求入口，例如主站展示的 API 端点
• 服务端保存密钥，不要把长期密钥直接暴露在浏览器代码里
• 先用最小模型和最短上下文完成联调，再扩展复杂场景

首个 curl 请求

curl --request POST "https://your-api-host/v1/chat/completions" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer sk-your-api-key" \
  --data '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "你是一个简洁的助手" },
      { "role": "user", "content": "你好，给我一句欢迎语" }
    ],
    "temperature": 0.7
  }'

如果这一步能稳定返回 choices 数据，说明网络、鉴权和模型路由已经打通。

联调时重点关注什么

检查项	建议
超时	首轮联调阶段先把超时时间放宽到 60 秒以上
日志	记录请求 ID、模型名、耗时和错误码，方便定位异常
重试	仅对网络抖动或明确可重试错误生效，避免无脑重复扣费

建议的接入顺序

1. 先在服务端打通单次请求
2. 再补业务侧参数校验和错误处理
3. 最后再接流式输出、批量任务或复杂上下文