---
description: "三步发起第一条请求，确认服务地址、密钥与返回结构。"
---

# 快速开始

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

## 接入前准备

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

## 首个 curl 请求

```bash
curl --request POST "https://oneapi.zaiwenai.com/v1/chat/completions" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer sk-your-api-key" \
  --data '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "system", "content": "你是一个简洁的助手" },
      { "role": "user", "content": "你好，给我一句欢迎语" }
    ],
    "temperature": 0.7
  }'
```

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

## 联调时重点关注什么

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

## 建议的接入顺序

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