Claude API Overview — Hướng Dẫn Bắt Đầu Với API Anthropic

Claude API là một RESTful API tại https://api.anthropic.com, cung cấp quyền truy cập lập trình vào các model Claude. API chính là Messages API (POST /v1/messages) dùng cho các tương tác hội thoại.

💡 Mới làm quen với Claude? Đọc Hướng Dẫn Bắt Đầu Với Claude API để xem các điều kiện tiên quyết và thực hiện API call đầu tiên, hoặc xem Hướng Dẫn Messages API để nắm rõ các mẫu request/response.

Điều Kiện Tiên Quyết

Để sử dụng Claude API, bạn cần:

• Tài khoản Anthropic Console
• API key (tạo tại Account Settings)

Các API Có Sẵn

Claude API bao gồm các nhóm API sau:

General Availability (Chính thức)

• Messages API (POST /v1/messages): Gửi tin nhắn đến Claude để tương tác hội thoại — API cốt lõi nhất
• Message Batches API (POST /v1/messages/batches): Xử lý hàng loạt requests không đồng bộ, tiết kiệm 50% chi phí
• Token Counting API (POST /v1/messages/count_tokens): Đếm token trước khi gửi để quản lý chi phí và rate limits
• Models API (GET /v1/models): Liệt kê các model Claude có sẵn và thông tin chi tiết

Beta (Thử nghiệm)

• Files API (POST /v1/files, GET /v1/files): Upload và quản lý file để dùng lại qua nhiều API calls
• Skills API (POST /v1/skills): Tạo và quản lý custom agent skills

Xác Thực (Authentication)

Mọi request đến Claude API đều phải bao gồm các headers sau:

💡 Lưu ý: Nếu bạn sử dụng Client SDKs chính thức, SDK sẽ tự động gửi các headers này — bạn không cần tự cấu hình.

Lấy API Keys

API được cung cấp qua Console. Bạn có thể dùng Workbench để thử nghiệm API trong trình duyệt, sau đó tạo API keys tại Account Settings. Sử dụng Workspaces để phân chia API keys theo use case và kiểm soát chi tiêu.

Client SDKs

Anthropic cung cấp các SDK chính thức giúp đơn giản hóa tích hợp API:

• Tự động quản lý headers (x-api-key, anthropic-version, content-type)
• Type-safe request và response handling
• Logic retry tích hợp và xử lý lỗi
• Hỗ trợ Streaming
• Request timeouts và connection management

Ví dụ Python SDK

from anthropic import Anthropic

# SDK tự động đọc ANTHROPIC_API_KEY từ environment
client = Anthropic()

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(message.content)

Xem danh sách đầy đủ các SDK tại Hướng Dẫn Claude Agent SDK.

Claude API vs Nền Tảng Third-Party

Claude có thể truy cập qua API trực tiếp của Anthropic hoặc qua các nền tảng đối tác. Lựa chọn dựa trên cơ sở hạ tầng, yêu cầu tuân thủ và sở thích về giá cả.

Claude API trực tiếp

• Truy cập trực tiếp vào các model và tính năng mới nhất đầu tiên
• Hóa đơn và hỗ trợ từ Anthropic
• Phù hợp nhất cho: Tích hợp mới, truy cập đầy đủ tính năng, quan hệ trực tiếp với Anthropic

Nền Tảng Third-Party

Truy cập Claude qua AWS, Google Cloud hoặc Microsoft Azure:

• Tích hợp với hệ thống thanh toán và IAM của cloud provider
• Có thể có độ trễ tính năng so với API trực tiếp
• Phù hợp nhất cho: Cam kết cloud sẵn có, yêu cầu tuân thủ đặc biệt, hóa đơn cloud hợp nhất

Giới Hạn Request và Response

Giới Hạn Kích Thước Request

API có giới hạn kích thước request tối đa khác nhau tùy endpoint:

⚠️ Lưu ý: Nếu vượt quá giới hạn, bạn sẽ nhận lỗi 413 request_too_large. Các nền tảng third-party có giới hạn riêng: Vertex AI giới hạn 30 MB, Amazon Bedrock giới hạn 20 MB.

Response Headers

Claude API bao gồm các headers trong mọi response:

• request-id: Mã định danh duy nhất toàn cầu cho request
• anthropic-organization-id: ID tổ chức liên kết với API key được sử dụng

Rate Limits và Availability

Rate Limits

API thực thi các giới hạn tốc độ và giới hạn chi tiêu để ngăn chặn lạm dụng và quản lý capacity. Các giới hạn được tổ chức thành usage tiers tăng dần tự động khi bạn sử dụng API. Mỗi tier có:

• Spend limits: Chi phí tối đa hàng tháng cho việc sử dụng API
• Rate limits: Số request tối đa mỗi phút (RPM) và token mỗi phút (TPM)

Bạn có thể xem giới hạn hiện tại của tổ chức tại Console.

Availability

Claude API có sẵn ở nhiều quốc gia và khu vực trên toàn cầu. Kiểm tra trang supported regions để xác nhận tính khả dụng ở vị trí của bạn.

Ví Dụ Cơ Bản

Dưới đây là request tối giản sử dụng Messages API:

curl

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

Response mẫu

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I assist you today?"
    }
  ],
  "model": "claude-opus-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}

Bước Tiếp Theo

Sau khi nắm rõ tổng quan Claude API, bạn có thể khám phá các tài liệu liên quan:

• Hướng Dẫn Bắt Đầu Với Claude API — Điều kiện tiên quyết, hướng dẫn từng bước và ví dụ đa ngôn ngữ
• Hướng Dẫn Messages API — Các mẫu request/response, hội thoại multi-turn và best practices
• Claude Agent SDK — Cài đặt và hướng dẫn cho Python, TypeScript, Java, Go, C#, Ruby và PHP
• Batch Processing Claude API — Xử lý hàng loạt tiết kiệm 50% chi phí
• MCP Connector Claude — Kết nối công cụ và dịch vụ bên ngoài