TÀI LIỆU KỸ THUẬT

Tài Liệu Tích Hợp API & Công Cụ

Kết nối ứng dụng, IDE (Cursor, Antigravity, VS Code) và các công cụ dòng lệnh tới toàn bộ các mô hình AI chỉ với một endpoint API tương thích hoàn toàn chuẩn OpenAI.

1. Khởi Động Nhanh Với SDK

Cài đặt thư viện OpenAI SDK chính thức bằng ngôn ngữ lập trình bạn sử dụng. Trỏ baseURL về TOZPIE Gateway và cung cấp Khóa API của bạn.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "aig_live_YOUR_API_KEY",
  baseURL: "https://api.tozpie.net/v1"
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "claude-3-7-sonnet",
    messages: [{ role: "user", content: "Viết một máy chủ HTTP hiệu năng cao bằng Golang." }],
    stream: true,
  });

  for await (const chunk of completion) {
    process.stdout.write(chunk.choices[0]?.delta?.content || "");
  }
}

main();

2. Xác Thực & Base URL

Tất cả các yêu cầu API phải được gửi tới địa chỉ cổng gateway chính thức qua giao thức HTTPS. Đính kèm Khóa API của bạn trong tiêu đề HTTP Authorization dưới dạng Bearer token.

# Địa chỉ Base URL chính thức:

https://api.tozpie.net/v1

# Tiêu đề HTTP Header:

Authorization: Bearer tp_live_••••••••••••••••••••••••••••••••

3. Tích Hợp IDE & Công Cụ Lập Trình

TOZPIE Gateway tương thích hoàn toàn với tất cả các IDE, extension lập trình và AI Agent phổ biến như Cursor, Antigravity, Cline, Roo Code, Continue, Aider...

Hướng dẫn cấu hình Cursor IDE

Cursor hỗ trợ trỏ trực tiếp endpoint sang các cổng tương thích chuẩn OpenAI. Bạn có thể sử dụng toàn bộ mô hình hàng đầu (Claude 3.7 Sonnet, GPT-4o, Gemini 2.5 Pro...) với chi phí tối ưu:

Mở Cursor Settings (Ctrl + , hoặc Cmd + ,) → chọn mục Models.
Bật tùy chọn OpenAI API Key và dán Khóa API TOZPIE của bạn (aig_live_YOUR_API_KEY).
Nhấp vào Override OpenAI Base URL và điền địa chỉ: https://api.tozpie.net/v1.
Trong danh sách Model Names, thêm các model bạn muốn sử dụng (ví dụ: claude-3-7-sonnet, gpt-4o, gemini-2.5-pro, deepseek-r1).

Cursor Model Settings / Reference

{
  "openai.baseUrl": "https://api.tozpie.net/v1",
  "openai.apiKey": "aig_live_YOUR_API_KEY",
  "cursor.models": [
    "claude-3-7-sonnet",
    "gpt-4o",
    "gemini-2.5-pro",
    "deepseek-r1"
  ]
}

4. Tạo Phản Hồi Trò Chuyện (Chat Completions)

Endpoint POST /v1/chat/completions chấp nhận toàn bộ tham số chuẩn OpenAI. TOZPIE tự động định tuyến yêu cầu tới nhà cung cấp tương ứng và chuẩn hóa cấu trúc dữ liệu trả về tức thì.

Tham số	Kiểu dữ liệu	Mô tả
model	string	Định danh mô hình mục tiêu (ví dụ: `gpt-5`, `claude-3-7-sonnet`, `gemini-3-6-pro`).
messages	array	Mảng các đối tượng tin nhắn chứa `role` và `content`.
stream	boolean	Kích hoạt truyền luồng dữ liệu từng đoạn qua Server-Sent Events (SSE).
temperature	number	Độ biến thiên ngẫu nhiên của phản hồi (từ 0.0 đến 2.0).

5. Bảng Mã Lỗi Chi Tiết

Mã Lỗi	Mã HTTP Status	Mô Tả Nguyên Nhân
invalid_api_key	401 Unauthorized	Khóa API bị thu hồi, sai định dạng hoặc không được cung cấp.
window_quota_exceeded	429 Too Many Requests	Hạn mức credits của chu kỳ hiện tại đã được sử dụng hết.
rate_limit_exceeded	429 Too Many Requests	Vượt quá giới hạn thông lượng RPM hoặc TPM của tài khoản / khóa.
subscription_required	402 Payment Required	Tài khoản chưa có gói cước đăng ký hợp lệ hoặc đã hết hạn.

TOZPIEĐang tải...