Trang chủ / Tài liệu / Bắt đầu nhanh

Bắt đầu nhanh

Lấ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.

Trang này hướng dẫn bạn từ lúc chưa thiết lập gì đến khi nhận được phản hồi thành công. Bạn chỉ cần có curl; các phiên bản SDK được nêu trong SDK.

Bước 1 — Tạo khóa

  1. Đăng ký tài khoản và xác nhận email của bạn.
  2. Nạp tín dụng hoặc mua gói không giới hạn. Tài khoản mới nhận được tiền thưởng cho lần nạp đầu tiên bằng tiền mã hóa — xem Bảng giá.
  3. Mở bảng điều khiển, đi đến Khóa APIvà tạo khóa. Khóa bắt đầu bằng sk-.
  4. Sao chép ngay — giá trị đầy đủ chỉ được hiển thị một lần.

Bước 2 — Xuất khóa thành biến môi trường

export CLAUDEAPIKEY="sk-your-key-here"

Bước 3 — Gọi API

Định dạng Anthropic

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Định dạng OpenAI

Cùng mô hình, khác cấu trúc bao ngoài — chọn định dạng phù hợp với ứng dụng khách của bạn:

curl https://aiprimetech.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDEAPIKEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Bước 4 — Xác nhận những mô hình bạn có thể truy cập

curl https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $CLAUDEAPIKEY"

Thao tác đó trả về mọi ID mô hình mà khóa của bạn có thể truy cập. Sử dụng nguyên văn các ID đó trong model .

Bước 5 — Cấu hình một công cụ thực tế để sử dụng API này

Với Claude Code, toàn bộ thiết lập chỉ gồm hai biến:

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="$CLAUDEAPIKEY"
claude
Nếu ANTHROPIC_API_KEY đã được đặt trong shell của bạn, Claude Code có thể tính phí qua khóa đó và âm thầm bỏ qua gói đăng ký của bạn. Hãy bỏ thiết lập biến này khi chuyển đổi. Xem Claude Code.

Khắc phục sự cố ở lần gọi đầu tiên

Dấu hiệuNguyên nhânCách khắc phục
401Thiếu khóa, nhập sai khóa hoặc gửi khóa trong header không đúngĐịnh dạng Anthropic sử dụng x-api-key; định dạng OpenAI sử dụng Authorization: Bearer
402Không có tín dụng và không có gói đang hoạt độngNạp tiền hoặc mua gói
404 trên /v1/chat/completionsỨng dụng khách đang gọi đường dẫn Anthropic với phần thân yêu cầu theo định dạng OpenAI hoặc ngược lạiChọn định dạng khớp với điểm cuối — xem Tổng quan
model_not_foundID mô hình không được viết chính xác như giá trị trả về từ /v1/modelsSao chép ID từ điểm cuối liệt kê mô hình