Khóa API của Anthropic là thông tin xác thực bạn gửi kèm theo mỗi yêu cầu tới API Claude. Nó bắt đầu bằng sk-ant-, bạn tạo nó trong Bảng điều khiển Claude, và nó tính phí sử dụng dựa trên tín dụng trả trước của tổ chức bạn. Nếu bạn chưa từng sử dụng khóa API, hướng dẫn cơ bản của chúng tôi về khóa API là gì sẽ trình bày ý tưởng chung. Hướng dẫn này bao gồm các bước cụ thể: tạo tài khoản Bảng điều khiển, nạp tín dụng, tạo khóa với phạm vi phù hợp, gửi yêu cầu Tin nhắn đầu tiên bằng curl và Python SDK, và sau đó giữ khóa an toàn.
Trang lấy khóa API của bạn chính thức của Anthropic cho bạn biết nút đó ở đâu. Nó không cho bạn biết tại sao yêu cầu đầu tiên trả về 401, ID mô hình nào hiện đang được sử dụng, hoặc cách kiểm tra khóa mà không dán nó vào lịch sử shell của bạn. Đó là những gì phần còn lại của hướng dẫn này đề cập.
button
Những gì bạn cần trước khi bắt đầu
- Một email để truy cập Bảng điều khiển Claude tại platform.claude.com (console.anthropic.com hiện chuyển hướng đến đó).
- Một thẻ thanh toán. API là trả trước, và chỉ vai trò Admin hoặc Billing mới có thể mua tín dụng.
- curl, hoặc Python 3.10+ cho ví dụ SDK.
- Apidog để lưu khóa dưới dạng biến cục bộ và lưu yêu cầu dưới dạng thử nghiệm có thể lặp lại. Gói miễn phí bao gồm các nhóm tối đa bốn người.
Bước 1: Tạo tài khoản Bảng điều khiển Claude
Đăng ký tại platform.claude.com. Thao tác này tạo ra một tổ chức với Không gian làm việc Mặc định, và tất cả các khóa, tín dụng và giới hạn tốc độ của bạn đều liên quan đến nó. Nếu một đồng đội đã tạo một tài khoản, hãy yêu cầu lời mời thay vì tạo một tổ chức thứ hai: tín dụng và các cấp sử dụng không thể chuyển giao.
Bước 2: Thêm tín dụng trước cuộc gọi đầu tiên của bạn
Đúng vậy, tín dụng ưu tiên. Tài liệu thanh toán của Anthropic rất rõ ràng: mua tín dụng trước khi bạn sử dụng API, và khi số dư bằng không, cả API lẫn sân chơi đều không hoạt động. Người dùng mới nhận được một lượng nhỏ tín dụng miễn phí để thử nghiệm, vì vậy hãy kiểm tra số dư của bạn trước khi mua, nhưng hãy coi đó là một phần thưởng chứ không phải kế hoạch.
Mở Settings > Billing và nhấp vào Buy credits. Bật tự động nạp lại nếu bạn đang chạy bất kỳ thứ gì không có người giám sát. Xem cách mua tín dụng để biết các bước hiện tại. Tổ chức của bạn cũng sẽ thuộc một cấp độ sử dụng với giới hạn chi tiêu hàng tháng, được đề cập trong phần giới hạn tốc độ.
Bước 3: Tạo khóa API
Truy cập Settings > API keys và nhấp vào Create key. Bốn lựa chọn quan trọng:
- Tên: đặt tên theo ứng dụng, không phải người.
orders-service-stagingtốt hơnmy key. - Thời hạn sử dụng: 3 giờ đến 30 ngày, tùy chỉnh, hoặc Không bao giờ. Chọn thời gian ngắn cho mục đích thử nghiệm; không thể thay đổi sau này.
- Tài khoản liên kết: chính bạn cho khóa cá nhân, tài khoản dịch vụ cho bất kỳ thứ gì được chia sẻ. Khóa cá nhân sẽ hết hạn khi bạn rời tổ chức.
- Không gian làm việc: giới hạn nó cho một không gian làm việc và bạn có thể bỏ qua tiêu đề
anthropic-workspace-id. Khóa đa không gian làm việc phải gửi tiêu đề này trong mỗi yêu cầu, nếu không bạn sẽ nhận được lỗi 400.
Bảng điều khiển chỉ hiển thị khóa đầy đủ đúng một lần, vì vậy hãy sao chép nó trực tiếp vào trình quản lý bí mật của bạn. Không có nút hiển thị. Nếu Create key bị xám, vai trò của bạn không thể tạo khóa; hãy hỏi quản trị viên.
Bước 4: Ba tiêu đề mà mỗi yêu cầu cần
Mỗi cuộc gọi đến POST https://api.anthropic.com/v1/messages đều mang ba tiêu đề.
| Tiêu đề | Giá trị | Ghi chú |
|---|---|---|
x-api-key |
khóa sk-ant-... của bạn |
Authorization: Bearer <key> cũng hoạt động và hiện là hình thức chính được ghi lại; x-api-key là phương án dự phòng cũ và vẫn được hỗ trợ |
anthropic-version |
2023-06-01 |
Bắt buộc. Định dạng phản hồi. Ngày này ổn định và không gắn liền với các bản phát hành mô hình |
content-type |
application/json |
Bắt buộc cho phần thân JSON |
Các SDK chính thức sẽ gửi cả ba tiêu đề này cho bạn. Các client HTTP thô và API cần chúng được chỉ rõ, đây là nguyên nhân gây ra hầu hết các lỗi yêu cầu đầu tiên. Tham khảo đầy đủ: Tổng quan API Claude.
Bước 5: Gửi yêu cầu Tin nhắn đầu tiên của bạn
Phần thân yêu cầu cần model, max_tokens và messages. Sử dụng ID mô hình hiện tại: tính đến tháng 9 năm 2026, đó là claude-opus-5 (mặc định được đề xuất), claude-fable-5-1 (có khả năng nhất), claude-sonnet-5, và claude-haiku-4-5. Các ID 3.x và 4.x cũ hơn sẽ trả về lỗi 404 hoặc trỏ đến các mô hình đã ngừng hoạt động, và các ID hiện tại không có hậu tố ngày. Hướng dẫn API Claude Opus 5 đi sâu hơn vào tư duy, nỗ lực và phát trực tuyến.
curl
export ANTHROPIC_API_KEY="sk-ant-api03-..."
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201."}
]
}'
Một phản hồi thành công, đã cắt gọn:
{
"id": "msg_01...",
"role": "assistant",
"model": "claude-opus-5",
"content": [{"type": "text", "text": "Creates a new order and returns it with a 201 status."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 31, "output_tokens": 24}
}
Đọc văn bản từ content[].text, kiểm tra stop_reason là end_turn, và giữ usage để theo dõi chi phí. Tiêu đề phản hồi request-id là thứ bộ phận hỗ trợ yêu cầu khi có lỗi xảy ra.
Python SDK
pip install anthropic
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{
"role": "user",
"content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201.",
}],
)
for block in message.content:
if block.type == "text":
print(block.text)
SDK đọc ANTHROPIC_API_KEY, thêm tiêu đề phiên bản và loại nội dung, và thử lại lỗi 429 và 5xx hai lần với cơ chế backoff. Không bao giờ truyền khóa dưới dạng chuỗi cố định; biến môi trường là mục đích chính.
Bước 6: Lưu trữ và kiểm tra khóa trong Apidog
Một khóa được dán vào shell sẽ nằm trong tệp lịch sử của bạn. Một khóa được lưu trữ trong yêu cầu chia sẻ sẽ đồng bộ với đồng đội. Apidog tách biệt hai điều này: cấu trúc yêu cầu được chia sẻ, bí mật vẫn nằm trên máy của bạn.
Lưu khóa dưới dạng biến cục bộ. Mở Environment Management, tạo một môi trường có tên Anthropic, và thêm một biến ANTHROPIC_API_KEY. Để giá trị chia sẻ là SET_LOCALLY và dán khóa thực vào giá trị cục bộ, khóa này sẽ nằm trong bộ nhớ cache của client của bạn và không bao giờ đồng bộ hóa. Hướng dẫn của chúng tôi về môi trường Apidog và các biến bí mật bao gồm các quy tắc về phạm vi.
Đặt các tiêu đề một lần. Trong cùng một bảng điều khiển, thêm hai tham số toàn cục dưới Headers: x-api-key đặt thành {{ANTHROPIC_API_KEY}}, và anthropic-version đặt thành 2023-06-01. Chúng áp dụng cho mọi yêu cầu trong dự án, và Apidog tự động thêm content-type cho một phần thân JSON.
Gửi yêu cầu đầu tiên. Yêu cầu mới, POST tới https://api.anthropic.com/v1/messages, dán phần thân JSON từ ví dụ curl, gửi. Mở tab Actual Request để xác nhận cả hai tiêu đề đã được gửi đi với biến đã được giải quyết. Tab đó là cách nhanh nhất để chứng minh rằng lỗi 401 là do vấn đề tiêu đề, không phải vấn đề khóa.
Lưu nó dưới dạng một bài kiểm tra. Lưu yêu cầu dưới dạng một trường hợp điểm cuối, sau đó thêm ba khẳng định: trạng thái bằng 200, stop_reason bằng end_turn, và usage.output_tokens lớn hơn 0. Chạy nó từ Apidog CLI và đưa khóa từ kho bí mật CI của bạn vào trong thời gian chạy. Đó là một bài kiểm tra khói một lần nhấp cho khóa, các tiêu đề và ID mô hình. Tải xuống Apidog để làm theo; gói miễn phí bao gồm bốn chỗ.
Giới hạn tốc độ và chi phí của một yêu cầu
Giới hạn áp dụng cho mỗi tổ chức và mỗi mô hình: số yêu cầu mỗi phút (RPM), số token đầu vào mỗi phút (ITPM), và số token đầu ra mỗi phút (OTPM). Chỉ đầu vào không được lưu vào bộ nhớ cache mới được tính vào ITPM, vì vậy việc lưu bộ nhớ cache cho lời nhắc sẽ tăng thông lượng mà không cần thay đổi cấp độ. Từ tài liệu giới hạn tốc độ:
| Cấp độ | Giới hạn chi tiêu hàng tháng | Claude Opus 5 (RPM / ITPM / OTPM) | Claude Fable 5.x (RPM / ITPM / OTPM) |
|---|---|---|---|
| Khởi đầu | $500 | 1,000 / 2M / 400K | 1,000 / 500K / 100K |
| Xây dựng | $1,000 | 5,000 / 5M / 1M | 2,000 / 1.5M / 300K |
| Mở rộng | $200,000 | 10,000 / 10M / 2M | 4,000 / 4M / 800K |
| Tùy chỉnh | none | đàm phán | đàm phán |
Sonnet 5 và Haiku 4.5 chia sẻ các con số của Opus 5 ở mỗi cấp độ. Mọi phản hồi đều mang các tiêu đề anthropic-ratelimit-*-remaining và -reset, vì vậy bạn có thể theo dõi dung lượng trống mà không cần phải thăm dò Bảng điều khiển.
Mỗi triệu token, từ trang giá: Opus 5 là 5 USD vào / 25 USD ra, Sonnet 5 là 2 USD / 10 USD, Fable 5.1 là 10 USD / 50 USD, Haiku 4.5 là 1 USD / 5 USD. Đọc bộ nhớ cache tốn 10% đầu vào (2,5% trên Fable 5.1) và API Batch giảm một nửa cả hai phía. Yêu cầu curl đầu tiên đó chỉ tốn một phần nhỏ của một xu.
Các lỗi thường gặp và cách khắc phục
Lỗi được trả về dưới dạng JSON với một error.type và một request_id. Tài liệu tham khảo lỗi liệt kê mọi mã lỗi; đây là những lỗi bạn sẽ gặp đầu tiên.
| Trạng thái và loại | Nguyên nhân thường gặp | Cách khắc phục |
|---|---|---|
401 authentication_error |
Khóa bị lỗi định dạng, bị thu hồi, hết hạn hoặc biến môi trường trống | echo $ANTHROPIC_API_KEY và kiểm tra khoảng trắng ở cuối; tạo khóa mới nếu nó đã hết hạn |
400 invalid_request_error |
Thiếu max_tokens, JSON bị lỗi định dạng, khóa đa không gian làm việc thiếu anthropic-workspace-id, thinking.type: enabled trên mô hình 4.7+, hoặc đạt giới hạn chi tiêu bạn đã đặt |
Đọc error.message; nó nêu tên trường hoặc giới hạn |
404 not_found_error |
Lỗi chính tả ID mô hình, một dự đoán có hậu tố ngày, mô hình đã ngừng hoạt động, hoặc đường dẫn sai | Sử dụng ID từ bảng mô hình hiện tại, và xác nhận đường dẫn là /v1/messages |
402 billing_error |
Vấn đề thanh toán hoặc tín dụng | Kiểm tra Settings > Billing |
429 rate_limit_error |
Bạn đã vượt quá RPM, ITPM hoặc OTPM | Đợi số giây trong retry-after, sau đó thử lại. Nếu không có tiêu đề retry-after có nghĩa là bạn đã đạt giới hạn chi tiêu hàng tháng của cấp độ (error_code: enforced_spend_limit_reached) |
500 api_error / 529 overloaded_error |
Lỗi phía Anthropic hoặc lưu lượng truy cập cao | Thử lại với backoff; giữ request_id |
Bảo mật khóa: xoay vòng, phạm vi và không bao giờ trong mã client
Không bao giờ đưa khóa vào trình duyệt hoặc ứng dụng di động. Bất cứ thứ gì trong gói JavaScript hoặc APK đều sẽ công khai trong vài phút. Hãy đặt cuộc gọi phía sau phần backend của riêng bạn. Đối với các ứng dụng Apple phải gọi trực tiếp Claude, App Attest cấp token có thời hạn ngắn cho các bản dựng đã xác minh thay vì một khóa tĩnh.
Một khóa cho mỗi ứng dụng và môi trường. Tách riêng khóa staging và production trong các không gian làm việc riêng biệt cho phép bạn giới hạn chi tiêu staging và thu hồi một khóa mà không ảnh hưởng đến khóa còn lại.
Xoay vòng khóa theo lịch trình. Tạo khóa mới, triển khai, xác nhận nó hoạt động, sau đó xóa khóa cũ. Vô hiệu hóa có thể đảo ngược; Xóa là vĩnh viễn. Nếu nghi ngờ rò rỉ, hãy vô hiệu hóa trước và điều tra sau. Một máy quét bí mật trong kho lưu trữ của bạn sẽ phát hiện các khóa đã được commit trước khi bất kỳ ai nhận ra.
Ưu tiên thông tin xác thực có thời hạn ngắn trong môi trường sản xuất. Workload Identity Federation hoán đổi token nhận dạng của nhà cung cấp đám mây của bạn lấy một token Claude có thời hạn ngắn, vì vậy không có chuỗi sk-ant- nào bị rò rỉ cả.
Câu hỏi thường gặp
Khóa API Anthropic có giống với khóa API Claude không?
Có. Bảng điều khiển, SDK và tài liệu hiện nay đều gọi là “API Claude”, và định dạng khóa cũng như các tiêu đề là giống hệt nhau. Các hướng dẫn cũ hơn đề cập đến “khóa API Anthropic” cũng có nghĩa là cùng một thông tin xác thực.
Tôi có thể nhận khóa API Anthropic miễn phí không?
Việc tạo khóa là miễn phí. Sử dụng nó sẽ trừ vào tín dụng trả trước, và trang giá của Anthropic nói rằng người dùng mới sẽ nhận được một lượng nhỏ tín dụng miễn phí để thử nghiệm. Nếu bạn đang cố gắng chạy các khối lượng công việc thực tế mà không phải trả tiền, hãy đọc phân tích trung thực của chúng tôi về truy cập API Claude miễn phí trước khi bạn xây dựng bất cứ điều gì xung quanh nó.
Đăng ký Claude Pro hoặc Max có bao gồm quyền truy cập API không?
Không. Các gói đăng ký Claude.ai và tín dụng API Console được tính phí riêng. Bạn cần một tổ chức Console với tín dụng, ngay cả khi bạn đã trả tiền cho Claude.ai.
Điều gì xảy ra khi khóa của tôi hết hạn?
Các yêu cầu sẽ trả về lỗi 401 authentication_error. Khóa đã hết hạn không thể kích hoạt lại, vì vậy hãy tạo một khóa mới và cập nhật biến môi trường. Anthropic sẽ gửi email cho người tạo khóa bảy ngày và một ngày trước khi khóa hết hạn đối với các khóa có thời gian sử dụng đủ dài.
Bước tiếp theo
Tạo khóa với thời hạn 7 ngày, đặt nó vào một biến cục bộ của Apidog, chạy bài kiểm tra khói, và sau đó mới tích hợp nó vào mã. Nếu bài kiểm tra đó thành công, thì thông tin xác thực, tiêu đề và ID mô hình đều chính xác, và mọi lỗi 401 sau đó là một vấn đề thực sự chứ không phải lỗi đánh máy.