Thiết lập shell và kiểm tra endpoint
Lấy khóa từ trang khóa API, sau đó xuất khóa cùng với base URL để bạn không dán bí mật vào mọi lệnh.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
Mỗi yêu cầu gửi khóa dưới dạng token bearer trong tiêu đề Authorization. Thân yêu cầu là JSON, vì vậy hãy thêm Content-Type: application/json khi bạn POST. Kích thước thân tối đa là 8 MB, điều này chỉ quan trọng nếu bạn dán các tài liệu rất lớn vào prompt.
Các ví dụ sử dụng dấu nháy đơn của shell Unix. Trên PowerShell Windows, hãy đặt JSON vào một tệp và truyền nó bằng --data @body.json để tránh rắc rối về trích dẫn.
Kiểm tra hợp lệ rẻ nhất là một lệnh GET liệt kê các mô hình. Nó xác nhận khóa và URL, và không tốn gì.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
Mảng data trong phản hồi nên bao gồm ID uncensored. Lỗi 401 có nghĩa là khóa bị thiếu hoặc gõ sai. Nếu curl không thể kết nối được chút nào, bạn kiểm tra host trong $BASE và đảm bảo nó kết thúc bằng /v1 mà không có đường dẫn bổ sung.
1. Gửi một yêu cầu hoàn tất hội thoại
Đây là yêu cầu mà mọi client kiểu OpenAI gửi ở lớp dưới.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
Phản hồi là JSON. Văn bản nằm ở choices[0].message.content, và số lượng token nằm ở usage. Chuyển hướng đầu ra qua jq -r '.choices[0].message.content' nếu bạn đã cài đặt jq và chỉ muốn lấy văn bản. Trường max_tokens là tùy chọn; hãy bỏ nó đi và việc hoàn tất có thể sử dụng dung lượng còn lại của cửa sổ 100.000 token.
Endpoint POST /v1/responses mới hơn cũng có sẵn nếu client của bạn sử dụng định dạng đó. Để biết danh sách đầy đủ các tham số, hãy xem tài liệu.
2. Truyền phát câu trả lời
Thêm "stream": true và bảo curl không đệm với -N. Token sẽ được in khi chúng được tạo ra.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
Mỗi dòng bắt đầu bằng data: và chứa một chunk JSON nhỏ với delta. Các sự kiện cuối cùng mang thông tin sử dụng, và luồng kết thúc bằng data: [DONE]. Không có -N, curl sẽ đợi một bộ nhớ đệm đầy, và đầu ra trông giống như nó đến cùng một lúc. Lưu ý rằng một yêu cầu truyền phát giữ một khe đồng thời bận cho đến khi nó kết thúc.
3. Yêu cầu JSON
Đối với đầu ra mà một kịch bản sẽ phân tích, bạn bật chế độ JSON với response_format. Bạn đề cập từ JSON trong prompt để mô hình biết hình dạng bạn mong đợi.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
Bộ lọc fromjson cuối cùng phân tích cú pháp chuỗi bên trong content, vì vậy jq sẽ báo lỗi rõ ràng nếu mô hình trả về thứ gì đó không phải là JSON hợp lệ. Điều đó khiến nó trở thành một bài kiểm tra nhanh hữu ích. Nhiều mẫu khác có trên trang chế độ JSON.
4. Thử gọi công cụ
Gọi hàm cho phép mô hình yêu cầu mã của bạn chạy một hàm. Bạn mô tả hàm trong một mảng tools, và nếu mô hình quyết định sử dụng nó, phản hồi sẽ chứa một mục tool_calls thay vì văn bản.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
Bạn nên nhận được tên hàm và một chuỗi JSON các đối số. Mã của bạn chạy hàm, sau đó gửi một yêu cầu thứ hai lặp lại các tin nhắn trước đó, thêm tin nhắn trợ lý với lệnh gọi công cụ, và thêm một tin nhắn với role: "tool" chứa kết quả. Mô hình sau đó viết câu trả lời cuối cùng.
5. Kiểm tra header và số dư
Thêm -i để xem header phản hồi cùng với thân. Bạn sẽ tìm thấy X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
Cuộc gọi thứ hai trả lại tín dụng của bạn trực tiếp. Các công cụ kiểu OpenAI có thể sử dụng GET /v1/dashboard/billing/credit_grants thay thế. Một yêu cầu nhỏ như trên chỉ tốn một phần nhỏ của một cent: với 10 token đầu vào và 5 token đầu ra, giá là 10 x 0,15 / 1.000.000 + 5 x 0,50 / 1.000.000 = $0,000004. Xem trang giá cả để biết các mức giá.
Một kịch bản kiểm tra nhanh có thể tái sử dụng
Khi bạn tin tưởng các lệnh gọi riêng lẻ, hãy gói chúng trong một kịch bản ngắn mà bạn có thể chạy sau bất kỳ lần triển khai, xoay khóa hoặc thay đổi mạng nào. Nó bị lỗi ở vấn đề đầu tiên, vì vậy bạn thấy chính xác bước nào đã bị hỏng.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
Cờ -f khiến curl thoát với lỗi khi xảy ra lỗi HTTP, và set -e dừng việc thực thi tập lệnh tại đó. Hãy đặt nó vào công việc cron hoặc bước CI nếu bạn chạy một dịch vụ dựa trên API này và muốn cảnh báo sớm khi có gì đó thay đổi. Hãy giữ khóa trong kho khóa bí mật hoặc biến môi trường, không bao giờ trong chính tệp tập lệnh.
Khi bạn thay đổi yêu cầu, hãy thử một cài đặt tại một thời điểm: temperature cho tính ngẫu nhiên, top_p cho lấy mẫu hạt nhân, stop cho các chuỗi kết thúc tùy chỉnh, và seed cho đầu ra có thể lặp lại. Tất cả chúng đều được chuyển tiếp đến mô hình, vì vậy bạn có thể so sánh tác động của chúng từ cùng một lịch sử terminal đó.
Đọc lỗi từ curl
| Trạng thái | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| 401 | Thiếu hoặc khóa sai | Kiểm tra tiêu đề Authorization và đảm bảo $API_KEY đã được xuất |
| 400 | JSON không hợp lệ hoặc trường không hợp lệ | Bạn xác thực thân với jq . trước khi gửi |
429, code rate_limited | Hơn 300 yêu cầu mỗi phút (60 trên khóa dùng thử) | Bạn làm chậm vòng lặp của bạn |
429, code concurrency | Hơn 8 yêu cầu cùng lúc (2 trên khóa dùng thử) | Chạy ít công việc song song hơn |
429 với Retry-After: 5 | Quá tải tạm thời | Chờ 5 giây và thử lại |
Thêm -w "\n%{http_code}\n" để in mã trạng thái sau thân, điều này giúp bạn không phải đoán. Thân lỗi là JSON với một thông báo và một mã, vì vậy jq .error sẽ hiển thị chúng một cách sạch sẽ. Nếu bạn thấy 429 trong một vòng lặp, đừng thử lại ngay lập tức; một khoảng dừng vài giây cho phép cửa sổ phút và các khe đồng thời được giải phóng, và một vòng lặp thử lại chặt chẽ chỉ giữ bạn vượt quá giới hạn. Khóa dùng thử có giới hạn chặt chẽ hơn khóa đầy đủ, vì vậy một tập lệnh hoạt động sau khi bạn nạp tiền lần đầu có thể thất bại trên tín dụng dùng thử nếu nó chạy các công việc song song. Khi các yêu cầu hoạt động, hãy chuyển sang SDK; cùng URL và tên mô hình được chuyển tiếp không thay đổi. Tài khoản mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột, đủ cho hàng trăm cuộc gọi thử nghiệm nhỏ. Nạp tiền sau đó bắt đầu từ $20 và được thanh toán bằng tiền mã hóa (USDT trên TRC20 hoặc USDC trên Base).
