Anthropic SDK

SDK chính thức Anthropic có thể gọi điểm vào tương thích Anthropic Messages của AGTCloud qua Base URL tùy chỉnh. Hướng dẫn này có ví dụ cài đặt, yêu cầu không dùng luồng và đầu ra dạng luồng cho Python và TypeScript.

Trang này chỉ trình bày gọi Messages. Tham khảo AGTCloud API Reference để biết khả năng sử dụng xử lý hàng loạt, tệp, API quản trị và tài nguyên nền tảng Anthropic khác.

Chuẩn bị

Trước khi bắt đầu, hãy đảm bảo bạn đã:

• Tạo AGTCloud API Key trên trang API Keys;
• Sao chép ID mô hình đầy đủ hỗ trợ Anthropic Messages từ danh mục mô hình;
• Chuẩn bị môi trường máy chủ với Python 3.9+ hoặc Node.js 20+.

Trang này dùng MODEL_ID và your-api-key làm giá trị giữ chỗ. Không lưu API Key thật trong giao diện trình duyệt, gói cài đặt di động hoặc kho mã công khai.

Cài đặt SDK

python -m pip install anthropic

Nên cài phiên bản ổn định hiện tại và cố định phiên bản thực tế bằng tệp khóa phụ thuộc của dự án.

Cấu hình API Key

Lưu API Key trong biến môi trường phía máy chủ:

export AGTCLOUD_API_KEY="your-api-key"

Mã ví dụ đọc thông tin xác thực từ AGTCLOUD_API_KEY và truyền rõ cho Anthropic SDK. SDK gửi thông tin này qua Header x-api-key, đồng thời tự thêm Header anthropic-version cần cho yêu cầu Messages.

Tạo máy khách và gửi yêu cầu

Dùng API Origin hiển thị trên trang này làm Base URL, không thêm /v1 hoặc /v1/messages. SDK nối đường dẫn Messages vào địa chỉ đó.

import os

from anthropic import Anthropic

api_key = os.environ["AGTCLOUD_API_KEY"]

client = Anthropic(
    api_key=api_key,
    base_url="https://api.agtcloud.cn",
)

message = client.messages.create(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Hãy giới thiệu bản thân bằng ba câu.",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

content của Anthropic Messages là mảng khối nội dung. Kiểm tra kiểu khối khi đọc văn bản, không giả định phản hồi luôn chỉ có một khối văn bản. Gọi công cụ, hình ảnh và nội dung khác dùng cấu trúc khối khác nhau.

Đầu ra dạng luồng

import os

from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["AGTCLOUD_API_KEY"],
    base_url="https://api.agtcloud.cn",
)

with client.messages.stream(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Hãy giải thích ngắn gọn tìm kiếm vectơ là gì.",
        }
    ],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Messages dạng luồng trả về qua sự kiện SSE. Trong môi trường sản xuất, xử lý cả mất kết nối, hết thời gian chờ, giới hạn tốc độ và chưa nhận đủ nội dung trước khi luồng kết thúc.

Câu hỏi thường gặp

Bước tiếp theo

• Xem Anthropic Messages API Reference để biết Content Blocks, gọi công cụ, tư duy mở rộng và toàn bộ trường phản hồi.
• Dự án SDK chính thức hiện có có thể theo Chuyển đổi SDK chính thức để thay từng cấu hình và kiểm thử hồi quy.
• Khi yêu cầu thất bại, xem Xác thực và API Key và Lỗi và khắc phục sự cố.