Tổng quan

Bắt đầu nhanh

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ậnPhù hợp nhất khi
APIToàn quyền kiểm soát, mọi ngôn ngữ, không phụ thuộc thư viện
OpenAI SDKĐã có code dùng OpenAI SDK, muốn drop-in replacement sang Trạm AI

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.

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 vào Console (chưa có tài khoản? Đăng ký tại đây)
  2. Vào trang API Keys
  3. Nhấn tạo key mới, đặt tên (label) và copy key tram_sk-... được hiển thị

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.

1import requests
2import json
3
4response = requests.post(
5  url="https://api.staging.tram.ai.vn/v1/chat/completions",
6  headers={
7    "Authorization": "Bearer <TRAM_AI_API_KEY>",
8  },
9  data=json.dumps({
10    "model": "~openai/gpt-latest",
11    "messages": [
12      {
13        "role": "user",
14        "content": "Ý nghĩa của cuộc sống là gì?"
15      }
16    ]
17  })
18)

API này cũng hỗ trợ streaming, cho phép 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.

1import OpenAI from 'openai';
2
3const openai = new OpenAI({
4  baseURL: 'https://api.staging.tram.ai.vn/v1',
5  apiKey: '<TRAM_AI_API_KEY>',
6});
7
8async function main() {
9  const completion = await openai.chat.completions.create({
10    model: '~openai/gpt-latest',
11    messages: [
12      {
13        role: 'user',
14        content: 'Ý nghĩa của cuộc sống là gì?',
15      },
16    ],
17  });
18
19  console.log(completion.choices[0].message);
20}
21
22main();