> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flatkey.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bắt đầu nhanh: Chọn cách bạn sẽ sử dụng Flatkey

> Bốn cách để sử dụng Flatkey — REST API, OpenAI SDK, Flatkey CLI, hoặc coding agent của bạn. Một khóa và một danh mục model đứng sau tất cả.

Flatkey cung cấp cho bạn một khóa và bốn cách để sử dụng nó. Cả bốn đều dùng chung một tài khoản, cùng số dư, và cùng danh mục model — vậy câu hỏi duy nhất là cách nào phù hợp với cách bạn làm việc.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/console-choose-how.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=99ada27fab6ab988299090f74cd627c0" alt="Bốn cách sử dụng Flatkey, được hiển thị trong Flatkey Console" width="3000" height="852" data-path="images/quickstart/console-choose-how.png" />
</Frame>

<Tip>
  Bạn không cần phải chọn một lần cho tất cả. Hãy bắt đầu với lựa chọn gần nhất với những gì bạn đang làm hôm nay, và thêm các lựa chọn khác sau này với cùng một khóa.
</Tip>

## Trước khi bắt đầu

Tạo một khóa tại [console.flatkey.ai/keys](https://console.flatkey.ai/keys). Khóa Flatkey bắt đầu bằng `sk-`. Mỗi lựa chọn dưới đây đều sử dụng khóa đó, vì vậy hãy lưu nó trong một biến môi trường và tránh xa mã nguồn.

Mỗi bảng trong Console cũng cho phép bạn chọn một khóa đã có sẵn thay vì tạo khóa mới, và tự động điền nó vào đoạn mã mẫu được hiển thị.

## API cho nhà phát triển

Gọi bất kỳ model nào qua HTTP thông thường với một yêu cầu tương thích với OpenAI. Không cần SDK, không cần dependency — nếu bạn có một HTTP client, bạn đã sẵn sàng.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-api.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=3dd0485d2730b29d52b3285bdbe176b7" alt="Bảng API cho nhà phát triển, với một yêu cầu sẵn sàng để chạy" width="1540" height="1150" data-path="images/quickstart/modal-api.png" />
</Frame>

Console sẽ xây dựng yêu cầu cho bạn: chọn một khóa, chọn một model, và sao chép đoạn mã bằng **cURL**, **Node.js**, hoặc **Python**.

```bash theme={"dark"}
curl https://router.flatkey.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Say hello in one sentence."}]}'
```

<Card title="Truy cập API" icon="code" href="/vi/guides/api-access">
  URL cơ sở, xác thực, các endpoint có sẵn, và xử lý lỗi.
</Card>

## SDK cho nhà phát triển

Giữ nguyên OpenAI SDK bạn đang dùng và trỏ nó tới Flatkey. Mã yêu cầu của bạn không thay đổi — chỉ có URL cơ sở là thay đổi.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-sdk.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=255f7df4814995aa07fb1816ad7342d1" alt="Bảng SDK cho nhà phát triển, với thiết lập SDK" width="1540" height="1150" data-path="images/quickstart/modal-sdk.png" />
</Frame>

Cùng ý tưởng như trên: chọn một khóa và một model, sau đó sao chép thiết lập cho ngôn ngữ của bạn.

```python theme={"dark"}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)
```

<CardGroup cols={2}>
  <Card title="OpenAI SDK" icon="code" href="/vi/guides/openai-sdk">
    Thiết lập Python và Node.js, streaming, và gọi công cụ (tool calling).
  </Card>

  <Card title="Anthropic SDK" icon="code" href="/vi/guides/anthropic-sdk">
    Định tuyến các yêu cầu Claude qua Flatkey theo cách tương tự.
  </Card>
</CardGroup>

## Flatkey CLI

Tạo hình ảnh và video từ terminal của bạn, hoặc để một trợ lý AI điều khiển CLI thay bạn.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-cli.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=a31f30bab8e5eecfc1f84fe593749af1" alt="Bảng Flatkey CLI, hiển thị cài đặt, đăng nhập, và lệnh đầu tiên" width="1540" height="930" data-path="images/quickstart/modal-cli.png" />
</Frame>

<Steps>
  <Step title="Cài đặt">
    ```bash theme={"dark"}
    npm i -g @flatkey-ai/cli
    ```
  </Step>

  <Step title="Đăng nhập">
    ```bash theme={"dark"}
    flatkey login
    ```
  </Step>

  <Step title="Bắt đầu tạo">
    Yêu cầu trợ lý AI của bạn thực hiện điều bạn muốn, và để nó chạy CLI:

    ```text theme={"dark"}
    Use Flatkey CLI to generate a "beautiful sunrise" picture.
    ```
  </Step>
</Steps>

<Card title="Flatkey CLI với AI Agent" icon="terminal" href="/vi/guides/flatkey-cli">
  Các lệnh, đầu ra JSON cho agent, và khôi phục lỗi.
</Card>

## Codex & Claude Code

Kết nối coding agent của bạn một lần, sau đó sử dụng Flatkey từ những dự án bạn đã mở sẵn.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-agents.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=0fadd534691bdc978983917445268b6f" alt="Bảng Codex và Claude Code, với lệnh cài đặt" width="1540" height="1064" data-path="images/quickstart/modal-agents.png" />
</Frame>

Console cung cấp cho bạn một lệnh cài đặt duy nhất cho **macOS**, **Linux**, hoặc **Windows**. Nó sẽ cài đặt agent nếu bạn chưa có, hỏi khóa của bạn, và tự viết cấu hình giúp bạn.

<Warning>
  Trình cài đặt là tương tác. Nó sẽ hỏi bạn muốn dùng Claude Code hay Codex CLI, và cần Node.js đã được cài đặt sẵn.
</Warning>

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/vi/guides/claude-code">
    Thiết lập thủ công hoặc CC Switch.
  </Card>

  <Card title="Codex CLI" icon="code" href="/vi/guides/codex-cli">
    Định tuyến Codex CLI qua Flatkey.
  </Card>

  <Card title="Codex Desktop" icon="desktop" href="/vi/guides/codex-desktop">
    Cấu hình ứng dụng desktop.
  </Card>
</CardGroup>

## Kiểm tra xem nó có hoạt động không

Dù bạn chọn lựa chọn nào, hãy mở **Usage Logs** trong [Console](https://console.flatkey.ai) sau yêu cầu đầu tiên của bạn. Bạn sẽ thấy nó được liệt kê cùng với model, số lượng token, độ trễ, và chi phí.

<img src="https://mintcdn.com/flatkey/ln614ti05NsEoN0h/images/quickstart/flatkey-usage-logs.png?fit=max&auto=format&n=ln614ti05NsEoN0h&q=85&s=90a23fb955d4a547c179087b73ab59df" alt="Sử dụng bộ lọc Model Name trong Flatkey Usage Logs" width="1600" height="840" data-path="images/quickstart/flatkey-usage-logs.png" />

Nếu không có gì xuất hiện, hãy đợi vài giây và tìm kiếm lại, sau đó xác nhận khóa API và URL cơ sở mà yêu cầu thực sự đã sử dụng.

## Các bước tiếp theo

<CardGroup cols={2}>
  <Card title="Danh mục Model" icon="list" href="https://flatkey.ai/models">
    Mọi model được hỗ trợ với giá cả và tình trạng hoạt động trực tiếp.
  </Card>

  <Card title="Lỗi API" icon="triangle-exclamation" href="/vi/api-reference/errors">
    Mã trạng thái, định dạng phản hồi, và cách xử lý chúng.
  </Card>

  <Card title="Tạo văn bản" icon="message" href="/vi/guides/text-generation">
    Streaming, gọi công cụ, và đầu ra có cấu trúc.
  </Card>

  <Card title="Tạo video" icon="video" href="/vi/guides/video-generation">
    Gửi một tác vụ, kiểm tra trạng thái, và tải xuống tệp MP4.
  </Card>
</CardGroup>