Claude API — Hướng Dẫn Tổng Quan Cho Developer Việt Nam

Claude API là 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 của Anthropic. API chính là Messages API (POST /v1/messages) dành cho tương tác hội thoại — đây là nền tảng để bạn tích hợp AI vào ứng dụng, workflow và sản phẩm của doanh nghiệp.

Dành cho doanh nghiệp SME Việt Nam muốn ứng dụng AI, hiểu rõ Claude API là bước đầu tiên để xây dựng chatbot, tự động hóa xử lý văn bản, phân tích dữ liệu, hay bất kỳ sản phẩm AI nào trong hệ sinh thái công nghệ của bạn.

Đ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 nhiều endpoint phục vụ các nhu cầu khác nhau:

General Availability (Sẵn sàng sử dụng)

Beta (Đang thử nghiệm)

Xác thực (Authentication)

Tất cả request đến Claude API đều cần bao gồm các header sau:

Lấy API Key

API được cung cấp qua web Console. Bạn có thể dùng Workbench để thử nghiệm API trực tiếp trên trình duyệt, sau đó tạo API key tại Account Settings. Dùng workspaces để phân tách API key theo từng use case và kiểm soát chi tiêu.

Client SDK

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

• Tự động quản lý header (x-api-key, anthropic-version, content-type)
• Type-safe request và response handling
• Retry logic và error handling tích hợp sẵn
• Hỗ trợ Streaming
• Quản lý timeout và kết nối

Ví dụ cơ bản với Python SDK

from anthropic import Anthropic

client = Anthropic()  # Đọc ANTHROPIC_API_KEY từ biến môi trường

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

print(message.content[0].text)

Cài đặt các SDK

# Python
pip install anthropic

# Node.js / TypeScript
npm install @anthropic-ai/sdk

# Java
# Thêm dependency vào pom.xml hoặc build.gradle

# Go
go get github.com/anthropics/anthropic-sdk-go

Anthropic hỗ trợ SDK cho: Python, TypeScript/JavaScript, Java, Go, C#, Ruby và PHP. Xem hướng dẫn cài đặt chi tiết tại Client SDKs documentation.

Ví dụ cơ bản — Gọi API trực tiếp với cURL

Đây là request tối thiểu sử dụng Messages API:

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": "Xin chào, Claude!"}
    ]
  }'

Response mẫu:

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Xin chào! Tôi có thể giúp gì cho bạn hôm nay?"
    }
  ],
  "model": "claude-opus-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 15
  }
}

Giới hạn Request & Rate Limits

Kích thước Request tối đa

Rate Limits theo Usage Tier

API áp dụng rate limits và spend limits để ngăn lạm dụng và quản lý capacity. Các giới hạn được tổ chức theo usage tier — tự động tăng khi bạn sử dụng nhiều hơn. Mỗi tier có:

• Spend limits: Chi phí API tối đa mỗi tháng
• Rate limits: Số request tối đa mỗi phút (RPM) và token mỗi phút (TPM)

Xem giới hạn hiện tại của tổ chức bạn tại Console → Limits. Nếu cần giới hạn cao hơn hoặc Priority Tier, liên hệ sales qua Console.

Response Headers quan trọng

Mỗi response từ Claude API đều bao gồm:

• request-id: ID duy nhất toàn cục cho request — dùng khi debug hoặc liên hệ support
• anthropic-organization-id: ID tổ chức gắn với API key được dùng

Claude API vs Nền tảng Bên Thứ Ba

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. Chọn dựa trên hạ tầng, yêu cầu compliance và preferences về thanh toán của bạn.

Bước tiếp theo

• Bắt đầu với Claude API — Hướng dẫn step-by-step thực hiện API call đầu tiên
• Messages API Guide — Pattern request/response, multi-turn conversation, best practices
• Streaming Guide — Nhận phản hồi thời gian thực, cải thiện UX
• Batch Processing — Xử lý hàng loạt, tiết kiệm 50% chi phí
• Claude Agent SDK — Xây dựng AI Agent tự động