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. Model phải thuộc nhóm của key, xem Mô hình & giá.

Gọi bằng cURL

Liệt kê model mà 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"}]
  }'

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.