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
- Đăng ký tài khoản và xác nhận email của bạn.
- 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á.
- Mở bảng điều khiển, đi đến Khóa APIvà tạo khóa. Khóa bắt đầu bằng
sk-. - 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ệu | Nguyên nhân | Cách khắc phục |
|---|---|---|
401 | Thiế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 |
402 | Không có tín dụng và không có gói đang hoạt động | Nạ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ại | Chọn định dạng khớp với điểm cuối — xem Tổng quan |
model_not_found | ID mô hình không được viết chính xác như giá trị trả về từ /v1/models | Sao chép ID từ điểm cuối liệt kê mô hình |