Trang chủTài liệu
Hướng dẫn nhanh cho người dùng Claude Code
Kết nối Claude Code hoặc bất kỳ tác nhân tương thích OpenAI nào với proxy của chúng tôi trong chưa đầy hai phút. Hướng dẫn nhanh này bao gồm URL cơ sở, xác thực và các endpoint chính xác bạn cần cho các tác vụ lập trình.
Xác thực
Mỗi yêu cầu đến proxy của chúng tôi cần khóa API hợp lệ. Bạn nhận được khóa này ngay sau khi đăng ký trên trang Lấy khóa API. Hãy đặt nó vào tiêu đề Authorization dưới dạng token Bearer. Nếu khóa thiếu hoặc không hợp lệ, API sẽ trả về lỗi 401. Bạn có thể tạo lại khóa bất kỳ lúc nào từ bảng điều khiển, việc này sẽ thu hồi ngay khóa cũ. Điều này đảm bảo các khóa bị mất hoặc bị xâm nhập không cho phép truy cập tiếp vào tín dụng trả trước của bạn.
Endpoint hoàn tất hội thoại
Gửi các prompt lập trình của bạn đến endpoint hoàn tất hội thoại tiêu chuẩn. URL cơ sở cho tất cả các yêu cầu là https://api.claudecodeapikey.com/v1. Sử dụng ID mô hình uncensored để truy cập mô hình ngôn ngữ lớn của chúng tôi. Mô hình này được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp, giúp nó lý tưởng để tạo mã mà không có các chặn không cần thiết. Endpoint hỗ trợ cả phản hồi tiêu chuẩn và truyền phát. Dưới đây là ví dụ về một yêu cầu cơ bản sử dụng curl.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Thân yêu cầu phải dưới 8 MB. Nếu bạn vượt quá giới hạn này, máy chủ sẽ từ chối dữ liệu. Mô hình xử lý cửa sổ ngữ cảnh 100.000 token, bao gồm cả token đầu vào và đầu ra. Điều này cho phép các đoạn mã đáng kể và lịch sử hội thoại dài mà không bị cắt ngắn ngay lập tức.
SDK Python
Đối với nhà phát triển sử dụng Python, bạn có thể tích hợp API của chúng tôi bằng SDK OpenAI chính thức. Chỉ cần trỏ client đến URL cơ sở của chúng tôi và cung cấp khóa API của bạn. ID mô hình uncensored hoạt động chính xác như các mô hình tương thích OpenAI khác trong SDK. Bạn có thể gọi phương thức hoàn thành và xử lý phản ứng như một đối tượng văn bản tiêu chuẩn. Cách tiếp cận này rất lý tưởng để xử lý hàng loạt hoặc tích hợp vào các tập lệnh tự động hóa lớn hơn.
from openai import OpenAI
client = OpenAI(base_url="https://api.claudecodeapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Hãy nhớ rằng SDK xử lý việc tuần tự hóa JSON cho bạn. Bạn chỉ cần đảm bảo biến base_url của bạn trỏ đến proxy của chúng tôi. Đối tượng phản hồi chứa văn bản được tạo, sau đó bạn có thể ghi vào tệp của mình hoặc đưa lại vào ngữ cảnh hội thoại.
SDK Node.js
Các nhà phát triển Node.js có thể sử dụng gói npm OpenAI để tương tác với proxy của chúng tôi. Cấu hình máy khách với URL cơ sở tùy chỉnh và khóa API của bạn. Mẫu sử dụng phản ánh việc triển khai Python: tạo máy khách, gọi endpoint hoàn tất hội thoại và xử lý kết quả. Điều này hữu ích cho việc tạo mã phía máy chủ hoặc trợ lý lập trình thời gian thực.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.claudecodeapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
SDK Node.js quản lý các kết nối HTTP một cách hiệu quả. Đảm bảo rằng bạn đang sử dụng phiên bản SDK hỗ trợ URL cơ sở tùy chỉnh. Cấu trúc phản hồi vẫn nhất quán với tiêu chuẩn OpenAI, giúp dễ dàng chuyển đổi giữa các nhà cung cấp tương thích OpenAI khác nếu cần.
Phản hồi truyền phát
Để hỗ trợ lập trình theo thời gian thực, hãy bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện gửi bởi máy chủ (SSE). Mỗi chunk chứa một phản hồi một phần, cho phép bạn hiển thị mã khi nó được tạo ra. Điều này cải thiện đáng kể trải nghiệm người dùng trong các tác nhân lập trình tương tác.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Xử lý các sự kiện luồng trong mã của bạn để tích lũy phản hồi cuối cùng. Truyền phát không tiêu tốn nhiều token hơn một yêu cầu không truyền phát; nó chỉ thay đổi cách dữ liệu được cung cấp. Điều này đặc biệt hữu ích cho các khối mã dài nơi bạn muốn hiển thị tiến trình ngay lập tức.
Giới hạn tốc độ & Hạn mức
API của chúng tôi áp dụng giới hạn 300 yêu cầu mỗi phút cho mỗi khóa API. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429. Bạn nên triển khai logic thử lại với backoff theo cấp số nhân trong các ứng dụng của mình. Ngoài ra, mỗi tài khoản chỉ giới hạn một khóa API, có thể được tạo lại nếu cần. Lỗi 402 cho biết tín dụng trả trước của bạn đã hết. Bạn có thể nạp tiền từ 10 USD bằng tiền điện tử (USDT hoặc USDC). Tín dụng không bao giờ hết hạn, vì vậy bạn có thể tạm dừng và tiếp tục sử dụng theo tốc độ của mình mà không mất số dư.
Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Xác thực | Authorization: Bearer YOUR_KEY |
| ID mô hình | uncensored |
| Base URL | https://api.claudecodeapikey.com/v1 |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $10 đến $500 |
| Thưởng | +5% từ $50, +10% từ $100 |
| Giá | $0,25 cho 1 triệu token đầu vào · $1,00 cho 1 triệu token đầu ra |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
| Đăng nhập | Google hoặc email và mật khẩu |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
Đây có phải là API chính thức của Anthropic không?
Không, đây là dịch vụ proxy độc lập. Chúng tôi lưu trữ mô hình ngôn ngữ lớn không kiểm duyệt của riêng mình tương thích với định dạng hoàn tất hội thoại OpenAI. Nó không phải là GPT, Claude hoặc bất kỳ mô hình của nhà cung cấp nào khác.
Sẽ xảy ra gì nếu tôi hết tín dụng?
Các yêu cầu sẽ trả về lỗi <code>402</code>. Bạn có thể nạp tiền vào tài khoản của mình bất cứ lúc nào từ 10 USD bằng tiền điện tử (USDT hoặc USDC). Tín dụng chưa sử dụng của bạn không bao giờ hết hạn, vì vậy bạn có thể thêm tiền khi thuận tiện.
Mô hình có từ chối nội dung không?
Mô hình được tinh chỉnh để trả lời mà không từ chối các chủ đề hợp pháp dành cho người trưởng thành, hư cấu hoặc gây tranh cãi. Giới hạn cứng duy nhất là nội dung tình dục liên quan đến trẻ vị thành niên luôn bị chặn.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ quá trình thiết lập.