Tổng quan

Trạm AI cung cấp API tương thích OpenAI, cho phép bạn dùng các thư viện OpenAI SDK có sẵn hoặc gọi HTTP trực tiếp.

Base URL

https://api.tramlabs.io/v1

Endpoints

EndpointMethodMô tả
/v1/chat/completionsPOSTChat completion (OpenAI-compatible)
/v1/completionsPOSTText completion (legacy — chưa có model hỗ trợ)
/v1/embeddingsPOSTTạo embeddings
/v1/messagesPOSTAnthropic Messages API
/v1/responsesPOSTOpenAI Responses API
/v1/images/generationsPOSTTạo ảnh từ text
/v1/images/editsPOSTChỉnh sửa ảnh
/v1/audio/speechPOSTText-to-Speech
/v1/audio/transcriptionsPOSTSpeech-to-Text
/v1/rerankPOSTRerank documents
/v1/videosPOSTTạo video (async)
/v1/videos/{id}GETXem trạng thái video job
/v1/videosGETLiệt kê video jobs
/v1/videos/{id}/contentGETTải video đã hoàn tất
/v1/modelsGETLiệt kê models
/public/modelsGETPublic model catalog (không cần auth)
/public/models/{model}GETChi tiết public model
/public/models/rankingsGETBảng xếp hạng models

Model Name

Tất cả các endpoint inference đều yêu cầu parameter model. Giá trị này là slug của model trên Trạm AI (ví dụ: gemini-3.5-flash), không phải tên nội bộ của provider.

Có 2 cách lấy tên model:

NguồnTrườngAuthVí dụ
GET /v1/modelsdata[].idCần API key"gemini-3.5-flash"
GET /public/modelsmodels[].modelNameKhông cần"gemini-3.5-flash"

Hoặc duyệt trực tiếp trên trang Models.

$# Lấy danh sách model (cần auth)
$curl https://api.tramlabs.io/v1/models \
> -H "Authorization: Bearer $TRAM_AI_API_KEY"
$
$# Lấy danh sách model (không cần auth)
$curl https://api.tramlabs.io/public/models

Response Format

Tất cả endpoint trả về JSON theo chuẩn OpenAI, ví dụ:

1{
2 "id": "chatcmpl-...",
3 "object": "chat.completion",
4 "choices": [
5 {
6 "index": 0,
7 "message": {
8 "role": "assistant",
9 "content": "..."
10 },
11 "finish_reason": "stop"
12 }
13 ],
14 "usage": {
15 "prompt_tokens": 10,
16 "completion_tokens": 20,
17 "total_tokens": 30
18 }
19}