TispLabs
TispLabs
Tài liệu

Hướng dẫn sử dụng API AI

Kết nối nhanh chóng API Key của bạn vào các công cụ và ứng dụng hỗ trợ lập trình AI hàng đầu như Cursor, Claude Code, Codex...

API Endpoint

https://api.tisplabs.tisp.vn/v1

Header: Authorization: Bearer sk_live_xxx

1 Chuẩn bị môi trường (Dành cho người mới)

Hầu hết các công cụ CLI lập trình AI đều yêu cầu môi trường chạy thử Node.js. Nếu máy tính của bạn chưa cài đặt Node.js, vui lòng thực hiện bước sau:

Dành cho Windows
  • Truy cập trang chủ Node.js (nodejs.org).
  • Tải về bản cài đặt LTS (khuyên dùng cho sự ổn định).
  • Chạy file .msi vừa tải và bấm Next liên tục để hoàn tất cài đặt mặc định.
Dành cho macOS / Linux
  • Mở terminal trên máy của bạn.
  • Nếu sử dụng macOS, bạn cài đặt nhanh qua Homebrew: brew install node.
  • Nếu sử dụng Linux (Ubuntu/Debian): sudo apt install nodejs npm.

2 Thiết lập & Cấu hình công cụ AI

Vui lòng nhập API Key của bạn để cá nhân hóa các câu lệnh cài đặt tự động, sau đó chọn công cụ AI bạn muốn cấu hình bên dưới.

Lưu ý: API Key của bạn chỉ được xử lý cục bộ trên trình duyệt để tạo câu lệnh/file cấu hình và không được gửi đi bất kỳ đâu.

💡 Hướng dẫn chạy file cài đặt tự động:
  • Windows: Click đúp chuột vào file .bat đã tải về để cấu hình tự động.
  • macOS / Linux: Click đúp vào file .command đã tải về. Nếu hệ thống báo thiếu quyền thực thi, hãy chạy lệnh: chmod +x ~/Downloads/tisplabs_setup_codex.command trong Terminal để cấp quyền.

A Cách 1: Cài đặt tự động (Khuyên dùng)

Tải file chạy hoặc copy câu lệnh Terminal bên dưới để cấu hình tự động cho Codex.

PowerShell (Windows) 
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; $code = (New-Object System.Net.WebClient).DownloadString('https://tisplabs.tisp.vn/public/scripts/setup.ps1'); & ([scriptblock]::Create($code)) -ApiKey '' -Tool 'codex'
Terminal (macOS / Linux) 
curl -fsSL https://tisplabs.tisp.vn/public/scripts/setup.sh | bash -s -- "" "codex"

B Cách 2: Cấu hình thủ công (Tùy chọn nâng cao)

Cấu hình Codex chạy qua API của TispLabs bằng cách tạo hoặc cập nhật các tệp tin cấu hình trong thư mục ~/.codex/ (Thư mục Home của User):

~/.codex/config.toml 
# TispLabs Configuration for Codex
model = "gpt-5.5"
model_provider = "tisplabs"

[model_providers.tisplabs]
name = "TispLabs"
base_url = "https://api.tisplabs.tisp.vn/v1"
wire_api = "responses"

[agents.subagent]
model = "gpt-5.5"
~/.codex/auth.json 
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk_live_YOUR_API_KEY"
}