TexAPI Docs v3

Đọc 60 giây, setup xong trong 3 phút.

Mục tiêu của trang này là giúp người mới dùng đúng key, đúng tool và test thành công ngay. Bạn chỉ cần chọn tool, copy cấu hình, và chạy lệnh test.

Lựa chọn tool, copy config, test một lần, rồi go live.Dữ liệu model được lấy trực tiếp từ runtime.

Public Base URL

https://api.texapi.dev/v1

Runtime Models

Chỉ hiển thị model đang dùng được.

Health Snapshot

000

Chưa có timestamp

Quick Start 3 bước

Step 1

Tạo key và đặt tên theo tool

Chọn profile key đúng ngay khi tạo: Server, CLI hoặc IDE Extension. Profile IDE Extension sẽ khóa fallback chéo nhóm.

Step 2

Chọn đúng tool và copy cấu hình

Không cần biết group token nội bộ. Chỉ cần dùng đúng hướng dẫn theo tool.

Step 3

Chạy lệnh test và kiểm tra status

Nếu test pass, bạn có thể đưa vào production ngay.

Health check command

bash

curl "https://api.texapi.dev/v1/models/status"

Hướng dẫn theo từng tool

OpenAI SDK / HTTP

Dùng cho backend, bot, automation.

Authorization: Bearer sk-tex-...

Phù hợp app cần gọi API ổn định và dễ monitor.

Không hardcode API key. Luôn đặt key trong ENV.

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TEXAPI_API_KEY,
  baseURL: "https://api.texapi.dev/v1"
});

const res = await client.chat.completions.create({
  model: "claude-sonnet-4-5-20250929",
  messages: [{ role: "user", content: "Write a hello world API route." }]
});

console.log(res.choices[0]?.message?.content);

Test command

bash

curl -X POST "https://api.texapi.dev/v1/chat/completions" \
  -H "Authorization: Bearer sk-tex-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [{"role":"user","content":"Reply exactly: TEXAPI_OK"}]
  }'

Compatibility Matrix

Tool	Protocol	Auth	Use case
OpenAI SDK / HTTP	OpenAI-compatible	Authorization: Bearer	Backend, bot, automation, API server.
Claude Code	Anthropic env bridge	ANTHROPIC_AUTH_TOKEN	Coding trong terminal với Claude.
Codex CLI	OpenAI responses wire	OPENAI_API_KEY	Code loop và task developer.
Gemini CLI	Gemini env bridge	GEMINI_API_KEY	Team đã standard hóa với Gemini CLI.
VSCode extensions	OpenAI-compatible	Authorization: Bearer	Cline/OpenCode và extension AI khác.

Lỗi thường gặp

invalid_request

Payload sai format.

Kiểm tra field bắt buộc và model ID.

model_not_supported

Model không đúng endpoint.

Lấy model hợp lệ từ /v1/models rồi gọi lại.

insufficient_quota

Không đủ số dư.

Nạp thêm credits hoặc giảm workload.

rate_limit_exceeded

Vượt giới hạn tốc độ.

Dùng exponential backoff 1s -> 2s -> 4s.

feature_not_enabled

Tính năng chưa được mở.

Liên hệ support để bật đúng profile key.

upstream_error

Lỗi tạm thời từ provider.

Retry có delay và fallback model.

Model status (live)

degradedSource: health-checkUpdated: Chưa có timestamp

Đang đồng bộ model runtime...

Rules để dùng đúng

Khóa fallback cho extension

Tạo key với profile IDE Extension để bật auto-safe routing. Hệ thống ưu tiên nhóm token hợp extension và vẫn fallback khi cần.

Chỉ dùng model public

Chỉ gọi model có trong /v1/models. Model không có trong list xem như không hỗ trợ.

Kiểm tra runtime trước khi scale

Trước khi đưa traffic lớn, check /v1/models/status để tránh route vào model đang suy giảm.

Log để giảm support ticket

Lưu request_id, model, latency, status code để đối soát nhanh khi có lỗi.

Cần setup nhanh cho team?

Tạo key riêng theo tool, copy docs này vào wiki nội bộ, và dùng chung checklist quick start.