# 快速开始

用一个最小请求确认 API Key、模型名和返回结构。

## 1. 准备 API Key

在控制台创建或选择一个 API Key。请求时把 Key 放到 `Authorization` 请求头：

```http
Authorization: Bearer <YOUR_API_KEY>
```

## 2. 查询可用模型

先调用模型列表，避免手写不存在或当前 Key 不可用的模型名。

```bash
curl https://kaienapi.com/v1/models \
  -H "Authorization: Bearer <YOUR_API_KEY>"
```

返回里的 `id` 就是后续请求使用的模型名。

## 3. 发送第一条文本请求

```bash
curl https://kaienapi.com/v1/chat/completions \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "把这条工单总结成一句话"}
    ]
  }'
```

非流式响应通常从 `choices[0].message.content` 读取文本。

## 4. 发送第一条图片请求

```bash
curl https://kaienapi.com/v1/images/generations \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张白底极简耳机产品海报",
    "size": "1024x1024",
    "quality": "low",
    "format": "jpeg",
    "n": 1
  }'
```

图片结果可能返回 URL，也可能返回 base64。客户端需要同时兼容这两类结果。

## 5. 查询用量

```bash
curl "https://kaienapi.com/v1/dashboard/billing/usage?start_date=2026-05-01&end_date=2026-05-06" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
```

金额展示应保留接口返回的精度，不要自行截成两位小数。