Skip to navigation
API Guides

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ụ:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}