Tài liệu

Bắt đầu nhanh

Tạo tài khoản để lấy khóa, rồi trỏ client của bạn tới https://api.unifyapi.ai/v1.

curl https://api.unifyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNIFYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Dùng SDK sẵn có

Mọi client tương thích OpenAI đều dùng được. Đặt URL gốc và khóa Unify API của bạn:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNIFYAPI_KEY"],
    base_url="https://api.unifyapi.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Hello"}],
)

Client kiểu Anthropic có thể dùng /v1/messages thay thế, với cùng một khóa.

Xác thực

Gửi khóa của bạn dưới dạng bearer token trong mọi yêu cầu. Khóa được tạo và thu hồi trong bảng điều khiển, và mỗi khóa có thể được giới hạn cho các mô hình cụ thể với hạn mức chi tiêu riêng.

Authorization: Bearer sk-...

Endpoint

Gọi GET /v1/models để xem chính xác khóa của bạn truy cập được những mô hình nào — danh sách đó là nguồn chính thức cho tài khoản của bạn.

Chọn mô hình

Truyền bất kỳ mô hình nào khóa của bạn có quyền dùng vào trường model. Unify API định tuyến yêu cầu tới nhà cung cấp đứng sau mô hình đó và tự động chuyển dự phòng nếu nhà cung cấp gặp sự cố, nên một tên mô hình vẫn hoạt động ngay cả khi phía thượng nguồn gặp sự cố.

Lỗi

Lỗi tuân theo định dạng lỗi của OpenAI, nên cách xử lý lỗi hiện có vẫn hoạt động. Mã 401 nghĩa là khóa bị thiếu hoặc đã bị thu hồi, còn 429 nghĩa là bạn đã chạm giới hạn tốc độ hoặc chi tiêu — cả hai đều xem được trong bảng điều khiển.