Trang chủ / Tài liệu

Tài liệu API Anthropic: tài liệu API Anthropic cho gateway API Claude

API Anthropic, với tài liệu dành cho gateway AI Prime Tech: cùng Messages API và các mã định danh mô hình, một URL cơ sở và một khóa — từ lệnh curl đầu tiên đến việc tăng cường độ ổn định và bảo mật cho môi trường vận hành thực tế. Mọi mô hình Claude hiện có đều được cung cấp.

curl https://claudeapikey.dev/v1/messages   -H "x-api-key: $ANTHROPIC_API_KEY"   -H "anthropic-version: 2023-06-01"   -H "content-type: application/json"   -d '{"model": "claude-sonnet-5", "max_tokens": 1024,
       "messages": [{"role": "user", "content": "Hello, Claude"}]}'

Bắt đầu trong bốn bước

  1. Tạo tài khoản và tạo khóa API trong bảng điều khiển.
  2. Đặt ANTHROPIC_BASE_URL thành địa chỉ máy chủ gateway và ANTHROPIC_API_KEY thành khóa của bạn — SDK tự thêm /v1/messages .
  3. Gửi yêu cầu theo định dạng Anthropic (/v1/messages) hoặc định dạng OpenAI (/v1/chat/completions).
  4. Chọn mã định danh mô hình từ GET /v1/models; chuyển mô hình bằng cách thay đổi một chuỗi.
Bắt đầu nhanhYêu cầu đầu tiên trong khoảng một phútClaude CodeHai biến môi trườngMô hìnhMã định danh, cửa sổ ngữ cảnh, mức giáTài liệu tham chiếu APIĐiểm cuối và lược đồ

Bắt đầu

Giới thiệuAI Prime Tech là gì, hỗ trợ những điểm cuối nào và khác với việc gọi trực tiếp Anthropic như thế nào.Bắt đầu nhanhLấy khóa, thiết lập hai biến môi trường và gửi yêu cầu đầu tiên trong khoảng một phút.Xác thựcCách gửi khóa của bạn, header mà mỗi định dạng yêu cầu và cách bảo vệ khóa.Mô hình và nhóm khóaKiểm tra các mô hình khả dụng với khóa API của bạn, chọn nhóm phù hợp và tìm giá mô hình hiện hành.URL cơ sởThiết lập khiến mọi người đều vướng mắc: URL mà từng ứng dụng khách yêu cầu, có và không có hậu tố /v1.Giải thích yêu cầu đầu tiên của bạnHướng dẫn từng dòng của một lệnh gọi Messages — chức năng của từng trường và dữ liệu trả về.

Tài liệu tham chiếu API

Tổng quan về APIMọi endpoint mà gateway cung cấp, định dạng mà từng endpoint sử dụng và dữ liệu trả về.API MessagesPOST /v1/messages — endpoint theo định dạng Anthropic: tham số, cấu trúc phản hồi và ví dụ.API Chat CompletionsPOST /v1/chat/completions — endpoint theo định dạng OpenAI, dành cho Cursor, LangChain, LiteLLM và các SDK OpenAI.Điểm cuối mô hìnhGET /v1/models — xác định chính xác các ID mô hình mà khóa của bạn có thể gọi.Truyền dữ liệu theo luồngSự kiện do máy chủ gửi ở cả hai định dạng — cấu trúc sự kiện khác nhau và nhầm lẫn giữa chúng sẽ khiến bạn tưởng rằng không có phản hồi.LỗiMọi mã trạng thái mà gateway trả về, nguyên nhân thực tế và cách khắc phục.Giới hạn tốc độCách giới hạn lưu lượng hoạt động, ý nghĩa của 429 ở đây và cách xây dựng ứng dụng khách không gặp tình trạng này.Sử dụng công cụ và gọi hàmCho phép mô hình gọi các hàm của bạn — vòng lặp yêu cầu, cả hai định dạng và những sai sót gây tốn token.Thị giác và đầu vào hình ảnhGửi hình ảnh đến các mô hình đa phương thức — cách mã hóa, giới hạn kích thước và chi phí.

Hướng dẫn tích hợp

Claude CodeKết nối tác nhân CLI của Anthropic với gateway bằng hai biến môi trường — và tránh lỗi khiến chi phí bị tính vào nhầm khóa mà không có thông báo.CursorSử dụng các mô hình Claude trong Cursor qua endpoint tương thích OpenAI mà không cần tài khoản Anthropic.ClineCấu hình tiện ích mở rộng Cline cho VS Code để sử dụng endpoint theo định dạng Anthropic.AiderChạy công cụ lập trình cặp trên terminal với gateway bằng một trong hai định dạng truyền dữ liệu.ZedThêm gateway làm nhà cung cấp trợ lý tùy chỉnh trong trình soạn thảo Zed.ContinueCấu hình tiện ích mở rộng Continue cho VS Code và JetBrains.Tiện ích mở rộng VS CodeNhững tiện ích mở rộng AI cho VS Code nào hỗ trợ URL cơ sở tùy chỉnh và cách kết nối từng tiện ích với gateway.Các IDE JetBrainsIntelliJ IDEA, PyCharm, WebStorm, GoLand và các công cụ còn lại — thông qua Continue hoặc plugin tương thích OpenAI.OpenCodeKết nối tác nhân lập trình mã nguồn mở trên terminal với gateway.Codex CLIChạy Codex CLI của OpenAI và tiện ích mở rộng Codex cho IDE với gateway, sử dụng các mô hình GPT hoặc Claude.OpenClawCấu hình framework tác nhân OpenClaw để sử dụng các mô hình của gateway.Máy chủ MCP cho Claude CodeMột cấu hình Model Context Protocol thực sự hữu ích cùng những cạm bẫy khiến bạn mất nhiều thời gian.Cấu hình khóa API theo công cụChọn đúng nhóm khóa, sau đó sử dụng khóa và URL cơ sở mà ứng dụng khách của bạn yêu cầu.

Làm việc với API

Kiểm soát chi phíToken thực sự được tiêu thụ ở đâu trong khối lượng công việc của tác nhân và bốn yếu tố có thể điều chỉnh để thay đổi chi phí.Lưu bộ nhớ đệm cho promptĐọc lại một tiền tố ổn định với chi phí chỉ bằng một phần giá đầu vào — nên lưu đệm nội dung nào, không nên lưu nội dung nào và cách xác minh việc lưu đệm đã hiệu quả.Quản lý ngữ cảnhVì sao chi phí của các phiên dài tăng phi tuyến và những cách giữ lịch sử trong giới hạn.Chuyển đổi từ API của AnthropicChuyển một cơ sở mã đang dùng SDK Anthropic sang gateway bằng cách thay đổi hai giá trị.Chuyển đổi từ API của OpenAIGiữ nguyên SDK OpenAI và truy cập các mô hình Claude bằng cách thay đổi URL cơ sở.Các phương pháp tốt nhất cho môi trường productionNhững điều cần thiết lập đúng trước khi một tích hợp xử lý lưu lượng thực tế.Khắc phục sự cốChỉ mục theo triệu chứng — tìm tình trạng bạn đang gặp và chuyển đến nguyên nhân.

SDK

Tổng quan về SDKCả SDK chính thức của Anthropic và OpenAI đều hoạt động mà không cần sửa đổi — hãy chọn theo định dạng bạn thích.PythonCác ví dụ hoạt động được với gói anthropic và openai, bao gồm truyền luồng và xử lý bất đồng bộ.TypeScriptCác ví dụ Node với @anthropic-ai/sdk và openai, bao gồm truyền luồng.cURLCác ví dụ không cần thư viện phụ thuộc cho mọi endpoint — hữu ích khi gỡ lỗi và kiểm tra CI.GoGọi gateway từ Go bằng thư viện chuẩn — không cần thư viện máy khách của bên thứ ba.

Thanh toán

Bảng giáCách quy đổi tín dụng thành token, các khoản thưởng và cách tính chi phí của một tác vụ.Tín dụngCách số dư trả trước hoạt động, những gì làm giảm số dư và cách tránh hết số dư giữa chừng.Các gói không giới hạnQuyền truy cập với mức phí cố định trong một khoảng thời gian xác định — bao gồm những gì và khi nào có lợi hơn tín dụng.Phương thức thanh toánThẻ và tiền mã hóa — nên dùng phương thức nào và vì sao mức thưởng khác nhau.Hoàn tiền và hỗ trợNhững khoản có thể hoàn tiền, những khoản không thể và cách báo cáo vấn đề thanh toán.

Tài nguyên

Câu hỏi thường gặpCâu trả lời trực tiếp cho những câu hỏi chúng tôi thực sự nhận được.Bảng thuật ngữĐịnh nghĩa chính xác các thuật ngữ được sử dụng xuyên suốt tài liệu này.Bảo mật và quyền riêng tưCách quản lý khóa, những gì nên tránh gửi và phạm vi của dịch vụ này.Nhật ký thay đổiNhững thay đổi đáng chú ý đối với các giao diện API, mô hình và tài liệu.Trạng thái và độ tin cậyCách gateway xử lý lỗi từ hệ thống thượng nguồn và những việc cần làm khi một thành phần bị suy giảm chất lượng.Khả năng cung cấp và phương thức thanh toánNhững nơi có thể sử dụng dịch vụ và cách thanh toán khi không thể sử dụng mạng lưới thẻ.

Tìm hiểu

Các bài giải thích dành cho người mua, bổ sung cho tài liệu kỹ thuật.

API tương thích với Anthropic có nghĩa là gìSDK Python của Anthropic: Cài đặt, base_url, truyền luồng, xử lý bất đồng bộ và xử lý lỗi (2026)Mua tín dụng Claude API: Hướng dẫn nạp tiền và thiết lậpCách tiết kiệm nhất để sử dụng Claude APILỗi máy chủ Claude? Giải thích từng lỗi Claude API — 400, giới hạn tốc độ 429, 500, quá tải 529 và cách khắc phục từng lỗiKhóa Claude API miễn phí? Những gì thực sự miễn phí — Claude API miễn phí, tín dụng dùng thử và lựa chọn thực tế rẻ nhất (2026)Hướng dẫn tích hợp Claude API: SDK, REST và các mẫu triển khai trong môi trường productionGiải thích các mô hình Claude 2026 — So sánh mô hình Claude: Claude Opus, Sonnet, Haiku và Fable, tên mô hình Anthropic và giáGiải thích giá Claude APICổng Claude API so với truy cập trực tiếp AnthropicClaude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nàoThanh toán Claude API bằng tiền mã hóaTruy cập Claude API không cần vào danh sách chờGiải thích giá Claude Code: Chi phí API, các gói và cách giảm chi phíKhóa API Claude Code (2026) — ANTHROPIC_API_KEY: Cách lấy khóa, claude setup-token, token OAuth so với khóa phiênClaude Code API: Cách hoạt động của khóa, URL cơ sở và thanh toán (2026)Cách sử dụng Claude không giới hạn: Các gói và giới hạnCách lấy khóa Claude API: Thiết lập trong bảng điều khiển và cổng APICách giảm lượng token sử dụng với ClaudeClaude API tương thích với OpenAI: Sử dụng Claude với SDK của OpenAI (base_url, truyền luồng, công cụ) (2026)Hermes Agent với Claude trên API riêng của bạn: config.yaml cho nhà cung cấp tùy chỉnh và kiểm soát chi phí (2026)Chạy OpenClaw không giới hạn trên ClaudeClaude API không giới hạn: Phạm vi áp dụng và giới hạn sử dụng hợp lýCách lấy khóa Claude API không giới hạn

Tất cả 45 bài viết trong mục Tìm hiểu →

Hướng dẫn API Codex và GPT: Khóa API và quyền truy cập Codex · API tương thích với OpenAI · Thiết lập Codex CLI · So sánh mô hình GPT-6