Tài liệu API

apikey.sh dùng đúng giao thức OpenAI. Mọi SDK, framework hay công cụ đang chạy với OpenAI đều dùng được ở đây sau khi đổi base_url.

Bắt đầu nhanh

Tạo key trong dashboard, đặt vào biến môi trường, rồi trỏ base URL:

from openai import OpenAI

client = OpenAI(
    api_key="sk-ak-...",                  # your key from apikey.sh
    base_url="https://apikey.sh/v1",      # change only this line
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

Base URL

Cùng một API key dùng được trên mọi domain dưới đây — chọn domain bạn thích.

https://apikey.sh/v1đang chạy

https://api.onie.net/v1đang chạy

Anthropic SDK dùng base URL không có /v1 (ví dụ https://apikey.sh).

Xác thực

Gửi key trong header:

Authorization: Bearer sk-ak-...

# or, with the Anthropic SDK:
x-api-key: sk-ak-...

Key chỉ hiện đúng một lần khi tạo. Nếu mất, hãy tạo key mới và thu hồi key cũ — thu hồi có hiệu lực ngay.

Endpoint

POST	`/v1/chat/completions`	Sinh completion (hỗ trợ SSE streaming và tool calling)
POST	`/v1/embeddings`	Tạo embedding cho RAG và tìm kiếm ngữ nghĩa
POST	`/v1/images/generations`	Tạo ảnh (model gpt-image-*)
GET	`/v1/models`	Liệt kê các model mà key hiện tại được phép dùng

Streaming

Thêm stream: true để nhận token theo thời gian thực qua SSE:

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Write a short poem"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Prompt caching

Với các model được hỗ trợ (dòng GPT-5.x), phần đầu prompt lặp lại sẽ tự động được cache và tính theo giá cache — rẻ hơn khoảng 90% so với token mới. Bạn không phải sửa gì trong code; số token đã cache xem ở mục Usage trong dashboard.Response có trường usage.prompt_tokens_details.cached_tokens để bạn tự đối chiếu.

Giới hạn theo key

Mỗi key có thể có hạn mức chi và danh sách model được phép riêng. Đây là cách an toàn để chia sẻ key giữa các dự án hoặc đồng đội mà không lo một bên tiêu hết ngân sách. Cấu hình tại Dashboard → API keys.

Mã lỗi

`401`	Key không hợp lệ, key đã thu hồi hoặc tài khoản bị khoá
`402`	Hết credit — nạp thêm trong dashboard
`403`	Model không nằm trong danh sách cho phép của key
`429`	Vượt rate limit của key
`5xx`	Lỗi từ nhà cung cấp upstream — thử lại sau vài giây

Model khả dụng

37 model đang hoạt động. Danh sách dạng máy đọc tại GET /v1/models hoặc /api/models (JSON, không cần auth).