Tham khảo API

Tài liệu API đầy đủ

URL cơ sở

https://api.thistoken.ai

Xác thực

Tất cả yêu cầu API phải bao gồm API Key trong header Authorization:

Authorization: Bearer YOUR_API_KEY

Endpoint

POST/v1/chat/completions

Tạo chat completion

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
model	string	Có	Tên mô hình, ví dụ gpt-4o, claude-3.5-sonnet
messages	array	Có	Mảng tin nhắn với role và content
temperature	number	Không	Nhiệt độ lấy mẫu, 0-2, mặc định 1
max_tokens	integer	Không	Số token tối đa sinh ra
stream	boolean	Không	Phát trực tiếp phản hồi, mặc định false

Ví dụ yêu cầu

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

POST/v1/embeddings

Tạo vector nhúng văn bản

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
model	string	Có	Tên mô hình nhúng, ví dụ text-embedding-3-small
input	string\|array	Có	Văn bản cần nhúng

Ví dụ yêu cầu

curl https://api.thistoken.ai/v1/embeddings \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

GET/v1/models

Lấy danh sách mô hình khả dụng

Ví dụ yêu cầu

curl https://api.thistoken.ai/v1/models \
  -H "Authorization: Bearer $API_KEY"

POST/v1/images/generations

Sinh hình ảnh

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
model	string	Có	Mô hình ảnh, ví dụ dall-e-3
prompt	string	Có	Mô tả ảnh
size	string	Không	Kích thước ảnh, ví dụ 1024x1024

Ví dụ yêu cầu

curl https://api.thistoken.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cute cat",
    "size": "1024x1024"
  }'

Mã lỗi

Mã	Mô tả
400	Tham số yêu cầu không hợp lệ
401	Xác thực thất bại — API Key không hợp lệ
402	Số dư không đủ
429	Vượt quá giới hạn tần suất
500	Lỗi máy chủ nội bộ