# 第一次 API 请求

## 准备
先创建 API Key，并确认当前密钥可用的模型 ID。本页示例从环境变量读取密钥和模型：`AOXTOKEN_API_KEY`、`AOXTOKEN_MODEL`。不要将真实密钥提交到仓库。

下面的 curl 命令使用 macOS/Linux shell 语法；Windows 可在已配置的 WSL 环境运行。模型 ID 应是服务端返回的准确值，不包含双引号等额外字符。

## curl

```bash
curl --fail-with-body https://api.aoxtoken.com/v1/chat/completions \
  -H "Authorization: Bearer $AOXTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$AOXTOKEN_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with OK\"}],\"stream\":false}"
```

## Python

安装 OpenAI Python SDK（`pip install openai`），设置上述环境变量后运行：

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AOXTOKEN_API_KEY"],
    base_url="https://api.aoxtoken.com/v1",
)
response = client.chat.completions.create(
    model=os.environ["AOXTOKEN_MODEL"],
    messages=[{"role": "user", "content": "Reply with OK"}],
)
print(response.choices[0].message.content)
```

## JavaScript

安装 OpenAI JavaScript SDK（`npm install openai`），将示例保存为 `request.mjs`，设置上述环境变量后用 Node.js 运行：

```javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AOXTOKEN_API_KEY,
  baseURL: "https://api.aoxtoken.com/v1",
});
const response = await client.chat.completions.create({
  model: process.env.AOXTOKEN_MODEL,
  messages: [{ role: "user", content: "Reply with OK" }],
});
console.log(response.choices[0].message.content);
```

## 验收
这三个示例仍需使用测试 Key、实际模型和记录下来的 SDK 版本分别运行。预期为返回文本并出现对应的本站用量记录；在此之前不应把示例视为已实测。失败时查阅[排错指南](/docs/zh/troubleshooting/)。