VI ▾
Lấy khóa API
API không kiểm duyệt tương thích OpenAI dành cho nhà phát triển.Cập nhật

Ví dụ curl API LLM để bạn sao chép và chạy

Nếu bạn muốn kiểm tra API LLM bằng curl trước khi viết mã, các yêu cầu dưới đây là đủ. Mỗi yêu cầu nhắm đến một endpoint tương thích OpenAI, dùng model ID uncensored và chạy từ terminal cơ bản.

Bảng terminal gửi một chùm sáng đến khối máy chủ, đại diện cho một yêu cầu curl đến API LLM

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áiNguyên nhân có thểCách khắc phục
401Thiếu hoặc khóa saiKiểm tra tiêu đề Authorization và đảm bảo $API_KEY đã được xuất
400JSON 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_limitedHơ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 concurrencyHơ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: 5Quá tải tạm thờiChờ 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).

Hỏi đáp

Tôi gửi các yêu cầu curl đến URL nào?

Bạn dùng https://api.uncensoredllmapi.com/v1 làm gốc, rồi thêm /chat/completions, /responses, /models hoặc /balance tùy nhu cầu.

Làm thế nào để tôi kiểm tra gọi hàm với curl?

Thêm mảng tools với định nghĩa hàm vào thân yêu cầu hoàn tất hội thoại. Nếu mô hình quyết định gọi hàm đó, phản hồi chứa tool_calls, và bạn gửi kết quả lại dưới dạng tin nhắn có role tool.

Tại sao curl không hiển thị gì cho đến khi phản hồi kết thúc?

Bạn có thể đang truyền phát mà không có cờ -N. Thêm -N để curl in từng chunk khi nó đến.

Yêu cầu thất bại có tốn tiền không?

Không. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí.

Bạn chỉ cần điền một biểu mẫu để có khóa

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.