Gọi API trực tiếp

Địa chỉ API

Xác thực bằng header Authorization: Bearer sk-.... Endpoint Anthropic nhận thêm header x-api-key. Mô hình phải thuộc nhóm của key, xem Mô hình & giá.

Gọi bằng cURL

Liệt kê các mô hình key của bạn dùng được:

curl https://api.apiz.vn/v1/models \
  -H "Authorization: Bearer $APIZ_API_KEY"

Gửi một tin nhắn (Chat Completions):

curl https://api.apiz.vn/v1/chat/completions \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Xin chào APIZ"}]
  }'

Responses API

Dùng key nhóm GPT. Codex CLI gọi endpoint này.

curl https://api.apiz.vn/v1/responses \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "input": "Xin chào APIZ"}'

Messages API (Anthropic)

Dùng key nhóm Claude.

curl https://api.apiz.vn/v1/messages \
  -H "x-api-key: $APIZ_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Xin chào APIZ"}]
  }'

Tạo ảnh

Dùng key nhóm GPT với mô hình gpt-image-2 hoặc gpt-image-2.5, tính tiền theo mỗi ảnh (xem Mô hình & giá). Mỗi ảnh mất khoảng 20–35 giây.

curl https://api.apiz.vn/v1/images/generations \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Ly cà phê sữa đá trên bàn gỗ, ánh nắng buổi sáng",
    "size": "1024x1024"
  }'

Ảnh PNG nằm ở đường dẫn data[0].url. Hãy tải ảnh về và tự lưu trữ ngay, vì đường dẫn này có thể hết hạn sau một thời gian.

Với Python SDK:

result = client.images.generate(
    model="gpt-image-2",
    prompt="Ly cà phê sữa đá trên bàn gỗ",
    size="1024x1024",
)
print(result.data[0].url)

Tạo video

Dùng key nhóm Video (hoặc key Tự động) với mô hình grok-imagine-video. Tính tiền theo số giây video: 500 ₫/giây, ví dụ video 6 giây là 3.000 ₫, 10 giây là 5.000 ₫ (xem Mô hình & giá). Video có tiếng, nói được tiếng Việt, thường xong sau 1–3 phút.

Bước 1. Gửi yêu cầu. Kết quả trả về id dạng task_... với status là queued:

curl https://api.apiz.vn/v1/videos \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Một cô gái mỉm cười cầm ly cà phê trong quán, nói: Chào buổi sáng các bạn.",
    "seconds": "6",
    "aspect_ratio": "9:16",
    "resolution": "720p"
  }'

Bước 2. Hỏi trạng thái mỗi 10–15 giây, đến khi status là completed (hoặc failed):

curl https://api.apiz.vn/v1/videos/task_xxx \
  -H "Authorization: Bearer $APIZ_API_KEY"

Bước 3. Tải video về:

curl -L https://api.apiz.vn/v1/videos/task_xxx/content \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -o video.mp4

Tham số: seconds là độ dài video tính bằng giây (6–15); aspect_ratio là 9:16 (dọc) hoặc 16:9 (ngang); resolution là 720p. Có thể dùng size kiểu OpenAI (720x1280, 1280x720) thay cho aspect_ratio. Tiền được trừ theo số giây bạn yêu cầu khi gửi.

Streaming

Thêm "stream": true để nhận câu trả lời theo từng phần. Với cURL, thêm -N để in ngay từng phần:

curl -N https://api.apiz.vn/v1/chat/completions \
  -H "Authorization: Bearer $APIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

Phản hồi có Content-Type: text/event-stream; mỗi phần là một dòng data: ..., Chat Completions kết thúc bằng data: [DONE].

Python

Cài SDK bằng pip install openai:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIZ_API_KEY"],
    base_url="https://api.apiz.vn/v1",
)

reply = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Xin chào APIZ"}],
)
print(reply.choices[0].message.content)

Node.js

Cài SDK bằng npm install openai:

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.APIZ_API_KEY,
  baseURL: 'https://api.apiz.vn/v1',
})

const reply = await client.chat.completions.create({
  model: 'claude-sonnet-5',
  messages: [{ role: 'user', content: 'Xin chào APIZ' }],
})
console.log(reply.choices[0].message.content)

Chỉ gọi API từ máy chủ. Không đưa key vào mã chạy trên trình duyệt hoặc biến môi trường public của framework.

Postman

Tạo request GET https://api.apiz.vn/v1/models với header Authorization: Bearer {{APIZ_API_KEY}}. Lưu key trong biến loại secret của Environment và không đồng bộ giá trị thật lên workspace dùng chung.

Dùng APIZ làm nguồn cho hệ thống relay

Nếu hệ thống của bạn tự nối thêm /v1/..., nhập https://api.apiz.vn; nếu ô nhập yêu cầu Base URL OpenAI đầy đủ, nhập https://api.apiz.vn/v1. Gọi /models trước để chắc chắn đường dẫn không bị lặp thành /v1/v1. Dùng key riêng có hạn mức cho relay, tách khỏi key cá nhân.