# Bắt đầu nhanh

> Dùng curl hoặc OpenAI SDK để gửi yêu cầu API LLMoxy đầu tiên.

LLMoxy là cổng tổng hợp mô hình lớn tương thích OpenAI. Bạn chỉ cần một API Key LLMoxy là có thể chuyển đổi giữa các mô hình OpenAI, Claude, Gemini..., không cần đăng ký hay quản lý riêng tài khoản của từng nhà cung cấp.

## Tạo API Key

1. Đăng ký và đăng nhập tài khoản tại [llmoxy.com](https://llmoxy.com).
2. Vào **Bảng điều khiển → Mã thông báo**, nhấp tạo mới.
3. Sao chép Key vừa tạo, thường bắt đầu bằng `sk-`. Hãy bảo quản cẩn thận; nếu bị lộ, hãy vô hiệu hóa ngay trên cùng trang này rồi tạo lại.

## Base URL

Mọi client tương thích OpenAI đều dùng cùng một địa chỉ:

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

Các định dạng yêu cầu khác (Anthropic, Gemini) dùng đường dẫn con cùng nguồn, xem chi tiết tại **Tương thích**.

## Yêu cầu đầu tiên

```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." }
    ]
  }'
```

Thay `<LLMOXY_API_KEY>` bằng Key bạn vừa tạo. Tên mô hình có thể xem qua `GET /v1/models`, hoặc duyệt trong danh sách mô hình của bảng điều khiển.

## 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)
```

## Đầu ra streaming

Đặt `stream: true` trong yêu cầu Chat Completions, LLMoxy sẽ trả về luồng SSE tương thích OpenAI.

```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." }
    ]
  }'
```

## Bước tiếp theo

- Dùng `GET /v1/models` để xem tất cả mô hình mà Key hiện tại có thể dùng.
- Đọc **Xác thực** để biết cách hỗ trợ các header yêu cầu theo kiểu của từng nhà cung cấp.
- Đọc **Chat Completions** để kết nối theo định dạng đó.

Đây là bản markdown của https://vi.llmoxy.com/docs/get-started/quickstart.
