本服务面向非中国大陆地区 · ZetaAPI.AI 的网站与控制台主要面向非中国大陆市场，注册与开通功能在你当前地区不可用。

Tham chiếu API

Endpoint, xác thực, định dạng tương thích, mã lỗi và giới hạn tần suất của ZetaAPI. Chuyển tiếp song song định dạng OpenAI và Anthropic — không cần đổi SDK.

Cập nhật 2026-04-17

Base URL

https://api.staging.cosmos-router.com

Xác thực

Mọi yêu cầu phải mang Authorization: Bearer sk-xxxxx:

curl https://api.staging.cosmos-router.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hi"}]}'

Định dạng Anthropic cũng nhận x-api-key (giống chính thức):

curl https://api.staging.cosmos-router.com/v1/messages \
  -H "x-api-key: sk-xxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "hi"}]}'

Tổng quan endpoint

EndpointGiao thứcGhi chú
POST /v1/chat/completionsOpenAIHoàn tất hội thoại, hỗ trợ stream SSE
POST /v1/completionsOpenAIHoàn tất văn bản kiểu cũ (mô hình cũ)
POST /v1/embeddingsOpenAIVector embedding
POST /v1/messagesAnthropicĐịnh dạng gốc của Claude, hỗ trợ prompt cache
GET /v1/modelsOpenAIDanh sách mô hình khả dụng cho tài khoản

Họ mô hình được hỗ trợ

Mô hình và giá được cập nhật theo mỗi lần triển khai; danh sách trên chỉ mang tính đại diện. Danh sách mô hình đầy đủ và hệ số giá mới nhất lấy trang bảng giá làm chuẩn.

Phản hồi dạng stream (SSE)

Đặt "stream": true trong yêu cầu:

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Viết quicksort bằng Python"}],
    stream=True,
)

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

SSE trả về định dạng data: {...}\n\n và kết thúc bằng data: [DONE] — y hệt API chính thức của OpenAI / Anthropic.

Prompt Cache

Mô hình OpenAI

Tự động cache, không cần tham số thêm. Tiền tố lặp lại được tính theo giá cache-hit (50% giá đầu vào hoặc thấp hơn, tùy mô hình).

Claude (định dạng Anthropic)

Đánh dấu tường minh trên block system hoặc messages:

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": [
    {
      "type": "text",
      "text": "Prompt hệ thống dài...",
      "cache_control": { "type": "ephemeral" }
    }
  ],
  "messages": [...]
}

Tỷ lệ cache-hit là 10% giá đầu vào, giống chính thức. Xem đo chi phí Prompt Cache.

Mã lỗi

HTTPCodeÝ nghĩaGợi ý
400invalid_request_errorSai tham số (thiếu trường, sai định dạng, sai tên mô hình)Kiểm tra body yêu cầu
401authentication_errorKey không hợp lệ hoặc đã thu hồiTạo lại key
402insufficient_quotaKhông đủ số dưNạp tiền trong bảng điều khiển
403permission_errorKey không có quyền với mô hình nàyKiểm tra quyền của key
404not_found_errorSai chính tả tên mô hìnhXem /v1/models
429rate_limit_errorChạm giới hạn tần suấtThử lại với backoff lũy thừa
500internal_errorLỗi nội bộ nền tảngTính vào thống kê sự cố; có thể yêu cầu bồi thường theo quy tắc công khai
502 / 503upstream_errorSự cố thượng nguồn, đang chuyển kênhClient có thể thử lại ngay
504timeout_errorThượng nguồn quá hạnClient có thể thử lại ngay

Body lỗi theo đúng định dạng OpenAI:

{
  "error": {
    "type": "invalid_request_error",
    "message": "model 'gpt-4-vision' not found",
    "code": null
  }
}

Giới hạn tần suất

Tự động chuyển kênh khi sự cố

Khi độ khả dụng của kênh thượng nguồn giảm bất thường, nền tảng tự chuyển lưu lượng sang kênh dự phòng — phần lớn trường hợp client không nhận biết.

Bồi thường SLA được tính theo tháng dương lịch + nhóm SKU; hiện theo hình thức gửi yêu cầu (duyệt thủ công); cách gửi yêu cầu và các bậc xem Yêu cầu bồi thường dịch vụ (bối cảnh thiết kế: Quy tắc bồi thường như một sản phẩm).

Hỗ trợ SDK

Thêm