Yêu cầu đầu tiên của bạn

Hướng dẫn này đưa bạn qua lệnh gọi API đầu tiên từ con số không. Trước khi bắt đầu, hãy chắc rằng:

1. Bạn đã tạo khóa API và lưu lại khóa đầy đủ.
2. Bạn đã có Base URL: đăng nhập bảng điều khiển, mở hộp thoại "Bắt đầu nhanh", chọn một giao thức và sao chép. Các ví dụ dưới đây dùng https://<your-base-url> làm giá trị giữ chỗ — hãy thay bằng địa chỉ thực tế của bạn.

Nền tảng hỗ trợ ba giao thức gốc; chọn cái nào phù hợp cũng được — cách tính phí và số dư giống hệt nhau ở cả ba.

Giao thức tương thích OpenAI (khuyến nghị mặc định)

Tương thích hoàn toàn với SDK OpenAI: trỏ base_url về nền tảng là mã hiện có của bạn chạy được ngay.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (SDK openai)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (SDK openai)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Giao thức Anthropic

Đẳng cấu với Anthropic Messages API: xác thực bằng x-api-key và kèm anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Giao thức Gemini

Đẳng cấu với Google GenAI API: model ID nằm trong đường dẫn, và xác thực dùng x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Kiểm tra kết quả

Một yêu cầu thành công trả về phản hồi của mô hình (với giao thức OpenAI thì nằm ở choices[0].message.content). Từ đó bạn có thể:

• Xem mức sử dụng và biến động số dư ở trang "Mức sử dụng" trong bảng điều khiển;
• Thay your-model bằng model ID thật lấy từ chợ mô hình (hỗ trợ các phương thức văn bản, hình ảnh, âm thanh, video và tệp).

Lỗi thường gặp trong lần gọi đầu

Mẹo cho production: giữ khóa trong biến môi trường (ví dụ OPENAI_API_KEY) thay vì viết cứng trong mã, và nên dùng SDK chính thức thay vì tự viết lệnh gọi HTTP — SDK đã xử lý sẵn các chi tiết tương thích giao thức.