Bắt đầu nhanh

Gửi yêu cầu đầu tiên của bạn trong 5 phút với AISieure API.

Lấy API Key

Để sử dụng AISieure API, bạn cần một API key có tiền tố key_. Có hai cách để lấy key:

Tự tạo qua Dashboard: Đăng nhập vào https://aisieure.com/login, vào mục API Keys trong dashboard và tạo key mới.
Liên hệ quản trị viên: Nếu bạn chưa có tài khoản, hãy liên hệ quản trị viên hệ thống để được tạo tài khoản và cấp gói sử dụng.

⚠ Bảo mật: API key là thông tin nhạy cảm. Không chia sẻ key công khai, không commit vào repository, và không nhúng trực tiếp trong code frontend. Luôn sử dụng biến môi trường để lưu trữ key.

Cài đặt nhanh với Install Script

Cách nhanh nhất để bắt đầu là sử dụng Install Script tự động:

Đăng nhập vào dashboard tại https://aisieure.com/dashboard/api-keys
Tạo một API key mới (hoặc sử dụng key đã có)
Nhấn nút ⬇ (Download) bên cạnh key để tải Install Script
Chạy script trên máy của bạn — script sẽ tự động cấu hình endpoint và API key

💡 Mẹo: Install Script sẽ tự động thiết lập endpoint URL và API key, giúp bạn bắt đầu sử dụng ngay mà không cần cấu hình thủ công.

Gửi yêu cầu đầu tiên

Sử dụng curl để gửi yêu cầu đầu tiên đến endpoint Chat Completions:

curl https://aisieure.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer key_your_api_key_here" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [
      {
        "role": "system",
        "content": "Bạn là một trợ lý AI hữu ích."
      },
      {
        "role": "user",
        "content": "Viết một hàm Python để tính giai thừa."
      }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'

Nếu thành công, bạn sẽ nhận được phản hồi JSON chứa câu trả lời của AI trong trường choices[0].message.content.

Streaming

Để nhận phản hồi theo thời gian thực (streaming), thêm "stream": true vào request body:

curl https://aisieure.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer key_your_api_key_here" \
  -N \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [
      {
        "role": "user",
        "content": "Giải thích cách hoạt động của blockchain."
      }
    ],
    "stream": true,
    "max_tokens": 2048
  }'

Phản hồi sẽ được gửi dưới dạng Server-Sent Events (SSE), mỗi dòng có định dạng:

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Blockchain"},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" là"},"finish_reason":null}]}

data: [DONE]

💡 Mẹo: Sử dụng cờ -N với curl để tắt buffering, giúp bạn thấy các chunk được gửi theo thời gian thực.

Sử dụng Responses API (Codex)

Với các model Codex (chuyên lập trình), sử dụng endpoint /v1/responses:

curl https://aisieure.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer key_your_api_key_here" \
  -d '{
    "model": "codex-mini",
    "input": "Viết hàm Python kiểm tra số nguyên tố",
    "instructions": "Trả về code ngắn gọn, có comment.",
    "stream": true
  }'

Phản hồi streaming sẽ gửi các event response.output_text.delta chứa từng đoạn text.

ℹ Lưu ý: Responses API sử dụng input (thay vì messages) và instructions (thay vì system message). Xem chi tiết tại API Reference.

Thử các mô hình khác

AISieure hỗ trợ nhiều mô hình. Chỉ cần thay đổi trường "model" trong request:

Mô hình	Dùng khi nào
`claude-sonnet-4.6`	Tác vụ thông thường — cân bằng chất lượng và tốc độ
`claude-opus-4.6`	Tác vụ phức tạp nhất, cần sáng tạo và phân tích sâu
`claude-haiku-4.5`	Tác vụ đơn giản, phản hồi nhanh, tiết kiệm credit
`gpt-4o`	Tác vụ đa phương thức, xử lý hình ảnh
`gpt-4o-mini`	Tác vụ nhẹ, chi phí thấp nhất
`gemini-2.5-pro`	Context dài, tổng hợp tài liệu lớn

Xem danh sách đầy đủ tại Danh sách mô hình hoặc gọi GET /v1/models.

Sử dụng với Python

Bạn có thể sử dụng thư viện openai chính thức của Python để kết nối với AISieure:

Cài đặt

pip install openai

Non-streaming

from openai import OpenAI

client = OpenAI(
    api_key="key_your_api_key_here",
    base_url="https://aisieure.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4.6",
    messages=[
        {
            "role": "system",
            "content": "Bạn là một trợ lý lập trình."
        },
        {
            "role": "user",
            "content": "Viết hàm merge sort trong Python."
        }
    ],
    max_tokens=1024
)

print(response.choices[0].message.content)

Streaming

stream = client.chat.completions.create(
    model="claude-sonnet-4.6",
    messages=[
        {
            "role": "user",
            "content": "Giải thích REST API là gì?"
        }
    ],
    stream=True,
    max_tokens=2048
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

Sử dụng với Node.js

Sử dụng package openai từ npm để tích hợp AISieure vào ứng dụng Node.js:

Cài đặt

npm install openai

Non-streaming

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "key_your_api_key_here",
  baseURL: "https://aisieure.com/v1",
})

const response = await client.chat.completions.create({
  model: "claude-sonnet-4.6",
  messages: [
    {
      role: "system",
      content: "You are a helpful assistant.",
    },
    {
      role: "user",
      content: "What is TypeScript?",
    },
  ],
  max_tokens: 1024,
})

console.log(response.choices[0].message.content)

Streaming

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4.6",
  messages: [
    {
      role: "user",
      content: "Explain async/await in JavaScript.",
    },
  ],
  stream: true,
  max_tokens: 2048,
})

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content
  if (content) process.stdout.write(content)
}

Bước tiếp theo

Bạn đã sẵn sàng sử dụng AISieure API! Dưới đây là các tài liệu hữu ích để tìm hiểu thêm:

Danh sách mô hình — Xem tất cả model được hỗ trợ, context window và giá credit
API Reference — Tài liệu chi tiết về tất cả endpoint
Tool Calls (Function Calling) — Hướng dẫn sử dụng function calling
Bảng giá — Xem các gói sử dụng và cách tính credit

💬 Cần hỗ trợ? Nếu gặp vấn đề trong quá trình tích hợp, hãy liên hệ với chúng tôi qua trang hỗ trợ hoặc cộng đồng để được giúp đỡ nhanh nhất.