Hướng dẫn API

Bắt đầu nhanh

1. 01

   Đăng nhập và tạo key ở trang Key.

2. 02

   Đổi Base URL của client sang địa chỉ bên dưới.

3. 03

   Gọi API như với OpenAI hoặc Anthropic — chỉ khác key và Base URL.

curl https://9aws.api-gate.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-8","messages":[{"role":"user","content":"Hello"}]}'

Thay YOUR_KEY bằng một key ở trang Key.

Base URL và xác thực

Mọi request cần key: gửi trong header Authorization dạng Bearer (kiểu OpenAI) hoặc header x-api-key (kiểu Anthropic).

Authorization: Bearer YOUR_KEY
x-api-key: YOUR_KEY

Chat Completions

Định dạng OpenAI Chat Completions — dùng được với mọi mô hình đang bán, kể cả Claude và Gemini.

POST/v1/chat/completions

curl https://9aws.api-gate.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-8","messages":[{"role":"user","content":"Hello"}]}'

Streaming

Thêm stream: true để nhận phản hồi từng phần qua Server-Sent Events, kết thúc bằng data: [DONE].

curl -N https://9aws.api-gate.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-8","stream":true,"messages":[{"role":"user","content":"Hello"}]}'

Claude Messages

Định dạng Anthropic Messages cho Claude Code và Anthropic SDK. SDK tự nối /v1/messages nên Base URL không kèm /v1.

POST/v1/messages

curl https://9aws.api-gate.cc/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-8","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

Danh sách mô hình

Trả về các mô hình key của bạn gọi được. Gọi đúng tên mô hình như trong danh sách.

GET/v1/models

curl https://9aws.api-gate.cc/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

• claude-opus-4-8
• claude-opus-5
• claude-sonnet-5

Claude Code

Dùng Claude Code (công cụ lập trình chạy trên terminal của Anthropic) với key của web này.

curl -fsSL https://claude.ai/install.sh | bash

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://9aws.api-gate.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KEY"
  }
}

claude --model claude-opus-4-8

Codex

Dùng Codex CLI (công cụ lập trình chạy trên terminal của OpenAI) với key của web này qua Responses API.

npm install -g @openai/codex

model = "claude-opus-4-8"
model_provider = "store"

[model_providers.store]
name = "9AWS"
base_url = "https://9aws.api-gate.cc/v1"
env_key = "API_KEY"
wire_api = "responses"

export API_KEY=YOUR_KEY
codex

Lỗi thường gặp

Lỗi trả về dạng JSON có error.code. Bảng dưới là các mã hay gặp và cách xử lý.

Cấu hình client

Mọi công cụ hỗ trợ OpenAI hoặc Anthropic đều dùng được — chỉ cần đổi địa chỉ và key.

OPENAI_BASE_URL="https://9aws.api-gate.cc/v1"
OPENAI_API_KEY="YOUR_KEY"