> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tramlabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tramlabs.io/_mcp/server.

# Bắt đầu nhanh

> Bắt đầu với Trạm AI

Trạm AI là một AI Gateway thống nhất, cho phép truy cập hàng trăm model AI từ nhiều nhà cung cấp (provider) khác nhau thông qua một API duy nhất. Thay vì phải tích hợp riêng lẻ với từng provider như OpenAI, Anthropic, Google, Mistral hay Meta, người dùng chỉ cần tích hợp một lần duy nhất với Trạm AI.

Có hai cách để tích hợp với Trạm AI:

| Cách tiếp cận                           | Phù hợp nhất khi                                                  |
| --------------------------------------- | ----------------------------------------------------------------- |
| [**API**](#t%E1%BA%A1o-api-key)         | Toàn quyền kiểm soát, mọi ngôn ngữ, không phụ thuộc thư viện      |
| [**OpenAI SDK**](#d%C3%B9ng-openai-sdk) | Đã có code dùng OpenAI SDK, muốn drop-in replacement sang Trạm AI |

> **Tip**
>
> Bạn cần thông tin về các model miễn phí và giới hạn tốc độ (rate limit)? Vui
> lòng xem [Câu hỏi thường gặp](/cau-hoi-thuong-gap#how-are-rate-limits-calculated).

---

## Tạo API Key

Trước tiên, người dùng cần tạo một API key để xác thực các request:

1. [Đăng nhập](https://console.tramlabs.io) vào Console (chưa có tài khoản? [Đăng ký tại đây](https://console.tramlabs.io/register))
2. Vào trang [API Keys](https://console.tramlabs.io/keys)
3. Nhấn tạo key mới, đặt tên (label) và copy key `tram_sk-...` được hiển thị

> **Warning**
>
> Key chỉ hiển thị **một lần** khi tạo. Hãy lưu lại ngay — người dùng sẽ không thể xem\
> lại key sau đó.

---

## Dùng Trạm AI API

Đây là cách nhanh nhất để dùng Trạm AI. Người dùng chỉ cần request HTTP tiêu chuẩn đến endpoint `/v1/chat/completions` . Trạm AI API tương thích với mọi ngôn ngữ và framework.

**`Python`**

```python title="Python" lines
import requests
import json

response = requests.post(
  url="https://api.tramlabs.io/v1/chat/completions",
  headers={
    "Authorization": "Bearer <TRAM_AI_API_KEY>",
  },
  data=json.dumps({
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Ý nghĩa của cuộc sống là gì?"
      }
    ]
  })
)
```

**`TypeScript (fetch)`**

```typescript title="TypeScript (fetch)" lines
fetch("https://api.tramlabs.io/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer <TRAM_AI_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-5.5",
    messages: [
      {
        role: "user",
        content: "Ý nghĩa của cuộc sống là gì?",
      },
    ],
  }),
});
```

**`Shell`**

```shell title="Shell" lines
curl https://api.tramlabs.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRAM_AI_API_KEY" \
  -d '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Ý nghĩa của cuộc sống là gì?"
    }
  ]
}'
```

API này cũng hỗ trợ **streaming**, cho phép [OpenAI SDK](#d%C3%B9ng-openai-sdk) trỏ tới Trạm AI như một giải pháp thay thế (**drop-in replacement**).

---

## Dùng OpenAI SDK

OpenAI SDK có thể được dùng để trỏ tới Trạm AI như một bản thay thế trực tiếp (drop-in). Cách này hữu ích nếu người dùng đã có sẵn code dựng trên OpenAI SDK và muốn truy cập danh mục model của Trạm AI mà không phải thay đổi cấu trúc code.

**`TypeScript`**

```typescript title="TypeScript" expandable lines
import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://api.tramlabs.io/v1',
  apiKey: '<TRAM_AI_API_KEY>',
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-5.5',
    messages: [
      {
        role: 'user',
        content: 'Ý nghĩa của cuộc sống là gì?',
      },
    ],
  });

  console.log(completion.choices[0].message);
}

main();
```

**`Python`**

```python title="Python" expandable lines
from openai import OpenAI

client = OpenAI(
  base_url="https://api.tramlabs.io/v1",
  api_key="<TRAM_AI_API_KEY>",
)

completion = client.chat.completions.create(
  model="gpt-5.5",
  messages=[
    {
      "role": "user",
      "content": "Ý nghĩa của cuộc sống là gì?"
    }
  ]
)

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