> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# OpenAI SDK 官方兼容

推理面与 OpenAI Chat Completions API 同形:`POST https://api.reelway.ai/v1/chat/completions`。

## 官方 SDK

| 语言                    | 接入                                                             |
| --------------------- | -------------------------------------------------------------- |
| JavaScript / TS       | `new OpenAI({ baseURL: 'https://api.reelway.ai/v1', apiKey })` |
| Python                | `OpenAI(base_url='https://api.reelway.ai/v1', api_key=…)`      |
| Go / .NET / Java 等官方库 | 同样以 `baseURL` + `api_key` 两项切换                                 |

任何以 OpenAI 协议为默认方言的框架(LangChain、LlamaIndex、AutoGen、Vercel AI SDK 等)同样适用。

## 平台差异

| 项          | 说明                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------- |
| 模型列表       | `GET /v1/models` 返回网关配置的模型;以运行时查询为准,不要硬编码                                                                                 |
| 计费         | 走 Reelway 余额,不走 OpenAI 账号;`429` 附 `Retry-After`                                                                           |
| Sogni 兼容字段 | `token_type` / `billing_mode` 仅作形状兼容;`sogni_tools` 未提供                                                                    |
| 创意能力       | 对话补全是纯文本(含函数工具);图像/视频/语音生成走 [rcn 生成面](https://docs.reelway.ai/api-reference/direct-generation.md),不在 `chat/completions` 内 |

## 验证连通

```bash
curl https://api.reelway.ai/v1/models \
  -H "Authorization: Bearer $REELWAY_API_KEY"
```

返回模型列表即接入成功;`401` 说明 Key 无效,见[API Keys](https://docs.reelway.ai/api-reference/api-keys.md)。