# 快速开始

> 使用 curl 或 OpenAI SDK 发送第一条 LLMoxy API 请求。

LLMoxy 是一个 OpenAI 兼容的大模型聚合网关。你只需要一个 LLMoxy API Key，就可以在 OpenAI、Claude、Gemini 等模型之间切换，不必分别申请或管理不同厂商的账号。

## 创建 API Key

1. 在 [llmoxy.com](https://llmoxy.com) 注册并登录账户。
2. 进入 **控制台 → 令牌**，点击新建。
3. 复制生成的 Key，通常以 `sk-` 开头。请妥善保管，泄露后立即在同一页面禁用并重新创建。

## Base URL

所有 OpenAI 兼容客户端都使用同一个地址：

```txt
https://llmoxy.com/v1
```

其他请求格式（Anthropic、Gemini）使用同源的子路径，详见 **兼容格式**。

## 第一条请求

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [
      { "role": "user", "content": "Say hello in one short sentence." }
    ]
  }'
```

把 `<LLMOXY_API_KEY>` 替换成你刚才创建的 Key。模型名可以通过 `GET /v1/models` 查看，或在控制台的模型列表中浏览。

## OpenAI SDK

```ts
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLMOXY_API_KEY,
  baseURL: "https://llmoxy.com/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.7",
  messages: [{ role: "user", content: "Write a haiku about routers." }],
});

console.log(response.choices[0]?.message?.content);
```

```py
from openai import OpenAI

client = OpenAI(
    api_key="<LLMOXY_API_KEY>",
    base_url="https://llmoxy.com/v1",
)

response = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "Write a haiku about routers."}],
)

print(response.choices[0].message.content)
```

## 流式输出

在 Chat Completions 请求中设置 `stream: true`，LLMoxy 会返回 OpenAI 兼容的 SSE 流。

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Count from one to five." }
    ]
  }'
```

## 下一步

- 使用 `GET /v1/models` 查看当前 Key 可用的所有模型。
- 阅读 **认证** 了解不同厂商风格请求头的支持。
- 阅读 **Chat Completions**，按该格式接入。

本文是 https://llmoxy.com/docs/get-started/quickstart 的 markdown 版本。
