VI ▾
Lấy khóa API

API kiểu OpenAI với cURL và Bearer Token

Để gọi API kiểu OpenAI từ dòng lệnh, bạn gửi HTTP POST với header Authorization chứa token của bạn. Trang này cung cấp các lệnh cURL hoạt động cho mọi tính năng của API này và các bước kiểm tra khi có lỗi.

Cập nhật

Cửa sổ terminal gửi khóa vàng và các gói dữ liệu qua dải sáng đến máy chủ

Điểm chính

  • Token được đặt trong header Authorization: Bearer YOUR_KEY, và ID mô hình là uncensored.
  • Có hai endpoint: GET /v1/models và POST /v1/chat/completions.
  • Thêm -N và stream true để xem token đến qua server-sent events.
  • Đọc X-Balance-USD và các header giới hạn tốc độ bằng curl -i; 429 nghĩa là đợi và thử lại.

Yêu cầu tối thiểu

Đây là cách ngắn nhất để thực hiện open ai api curl với token chống lại dịch vụ này. Đặt khóa vào biến môi trường để nó không xuất hiện trong lịch sử shell của bạn, sau đó gửi tin nhắn chat:

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

Phản hồi là JSON theo định dạng chat completion của OpenAI. Câu trả lời nằm ở choices[0].message.content, và đối tượng usage trả về token prompt và completion. Mỗi phần của lệnh có một nhiệm vụ:

  • Authorization: Bearer ... mang token. "Bearer" là tên scheme; người giữ token sẽ được coi là chủ sở hữu, đó là lý do bạn giữ nó khỏi các kho lưu trữ công khai.
  • Content-Type: application/json cho máy chủ biết cách đọc thân yêu cầu. Không có nó, yêu cầu thường thất bại với lỗi phân tích cú pháp thân.
  • model phải là uncensored, mô hình duy nhất mà API này cung cấp.
  • messages là danh sách các đối tượng có role (system, user, assistant hoặc tool) và content.

Để lấy khóa, hãy đăng ký bằng Google hoặc email và mật khẩu, sau đó sử dụng trang API key. Người dùng 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: không cần thẻ, có hiệu lực trong 7 ngày, một lần mỗi người.

Kiểm tra khóa bằng GET /v1/models

Trước khi gỡ lỗi một yêu cầu dài, hãy xác nhận token hoạt động bằng lệnh gọi rẻ nhất có thể. Liệt kê mô hình không tốn gì và cho biết URL, header và khóa có đúng không.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Một câu trả lời tốt là danh sách JSON bao gồm uncensored. Nếu bạn đã cài đặt jq, hãy pipe đầu ra để trích xuất chỉ các ID:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Nếu không nhận được kết quả hữu ích, hãy làm theo danh sách dưới đây theo thứ tự, vì các nguyên nhân được liệt kê theo tần suất xảy ra:

  1. Biến rỗng. Chạy echo "${UF_KEY:0:6}" để xem các ký tự đầu tiên mà không in toàn bộ khóa.
  2. Tiêu đề bị sai chính tả, hoặc "Bearer" bị thiếu trước khóa.
  3. Dấu ngoặc kép cong từ tài liệu hoặc ứng dụng chat đã thay thế dấu ngoặc kép thẳng trong lệnh.
  4. URL cơ sở không đúng. Đó là https://api.unfilteredaimodels.com/v1, với api. ở phía trước và /v1 ở phía cuối.
  5. Khóa được sao chép kèm theo khoảng trắng hoặc ký tự xuống dòng ở cuối.

Đọc các tiêu đề phản hồi

Thêm -i để bao gồm header trong đầu ra, hoặc -D - để in chúng trong khi giữ thân sạch sẽ:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Bốn header phản hồi đáng để biết:

Tiêu đềÝ nghĩa
X-Request-IdĐịnh danh cho yêu cầu này. Hãy trích dẫn nó nếu bạn liên hệ hỗ trợ.
X-Balance-USDTín dụng trả trước còn lại của bạn.
X-RateLimit-Limit-RequestsSố yêu cầu mỗi phút được phép cho khóa của bạn.
X-RateLimit-Limit-ConcurrencySố yêu cầu đồng thời được phép cho khóa của bạn.

Các giới hạn là 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời cho khóa đầy đủ, và 60 yêu cầu mỗi phút cùng 2 yêu cầu đồng thời cho khóa dùng thử. Yêu cầu trên đặt max_tokens thành 5 chỉ để giữ cho bài kiểm thử nhỏ. Trong sử dụng thông thường, max_tokens là tùy chọn, và phần hoàn thành có thể sử dụng bất kỳ phần còn lại nào của cửa sổ 100.000 token sau prompt của bạn.

Truyền phát từ dòng lệnh

Đặt "stream": true và thêm -N để curl không bộ đệm đầu ra. Bạn sẽ thấy các dòng bắt đầu bằng data:, mỗi dòng mang một delta JSON nhỏ, và một dòng data: [DONE] cuối cùng. Chunk trước đó bao gồm việc sử dụng token.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Để chỉ in văn bản, hãy lọc luồng bằng một pipeline ngắn:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

Một yêu cầu truyền phát giữ vị trí độ đồng thời của nó cho đến khi luồng kết thúc. Nếu bạn bắt đầu nhiều luồng song song từ một script và quên để chúng kết thúc, bạn sẽ chạm giới hạn độ đồng thời mặc dù tốc độ yêu cầu thấp.

Chế độ JSON và gọi công cụ

Chế độ JSON khiến mô hình trả về một đối tượng JSON hợp lệ duy nhất. Hãy nêu cấu trúc bạn muốn trong prompt, nếu không các khóa sẽ là bất kỳ thứ gì mô hình chọn.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

Gọi công cụ sử dụng các trường tools và tool_choice tiêu chuẩn. Mô hình trả lời bằng mảng tool_calls thay vì văn bản; bạn tự chạy hàm và gửi kết quả lại dưới dạng tin nhắn với role: "tool" và tool_call_id tương ứng.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

Trong phản hồi, hãy tìm choices[0].message.tool_calls[0].function.arguments. Đó là một chuỗi JSON bạn phân tích, gọi hàm thời tiết của riêng bạn với nó và trả lại trong yêu cầu tiếp theo. Các tham số như temperature, top_p, stop, seed và các hình phạt được chuyển tiếp. tài liệu liệt kê tất cả các trường được hỗ trợ.

Giữ token an toàn và các lệnh gọn gàng

Bearer token là mật khẩu với tên gọi khác. Bất kỳ ai có nó đều có thể tiêu tốn tín dụng của bạn, vì vậy hãy đối xử với nó cẩn thận như nhau. Không bao giờ dán khóa thật vào một vấn đề công khai, một ảnh chụp màn hình hoặc nhật ký terminal chia sẻ. Nếu bạn nghi ngờ khóa bị rò rỉ, hãy thay thế nó từ trang khóa và cập nhật các script của bạn.

Lịch sử shell là nơi rò rỉ phổ biến nhất trên máy cá nhân. Gõ khóa trực tiếp vào lệnh lưu nó vào tệp lịch sử. Đặt nó một lần bằng export vẫn lưu dòng đó. Hai thói quen sạch hơn sẽ giúp ích. Đọc khóa từ một tệp mà chỉ bạn mới có thể mở, hoặc tiền tố lệnh bằng dấu cách nếu shell của bạn được đặt để bỏ qua các dòng bắt đầu bằng dấu cách. Một tệp nhỏ hoạt động tốt:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Các thân JSON dài khó đọc trong dấu ngoặc đơn, và việc trích dẫn bị phá vỡ ngay khi prompt chứa một dấu nháy đơn. Hãy đặt thân vào một tệp và để curl đọc nó bằng -d @file:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Cách tiếp cận tương tự giữ các prompt lớn dưới giới hạn thân 8 MB dễ quản lý, và một tệp có thể được kiểm soát phiên bản trong git trong khi khóa vẫn ở ngoài kho lưu trữ. Trên PowerShell của Windows, dấu ngoặc đơn xung quanh JSON hoạt động khác biệt và việc tiếp tục dòng bằng dấu gạch chéo ngược không tồn tại; dạng -d @request.json tránh cả hai vấn đề, và bạn có thể sử dụng dấu backtick ở cuối dòng để tiếp tục một lệnh.

Khi bạn hoàn thành kiểm tra, hãy chuyển sang SDK. Thư viện Python và Node của OpenAI chấp nhận cùng base URL và khóa, xử lý việc thử lại và truyền phát cho bạn, và đọc cùng định dạng phản hồi mà bạn đã phân tích bằng tay ở đây. Các lệnh cURL vẫn là cách nhanh nhất để kiểm tra xem lỗi đến từ mã của bạn hay từ chính yêu cầu, vì vậy hãy giữ một lệnh đã biết là đúng trong ghi chú của bạn. Khi bạn báo cáo sự cố cho hỗ trợ, hãy bao gồm X-Request-Id của lệnh gọi không thành công và mã trạng thái chính xác; cặp đó cho phép ai đó tìm yêu cầu mà không yêu cầu bạn lặp lại bài kiểm tra, và nó tiết kiệm một vòng trao đổi qua lại.

Lỗi, thử lại và chi phí cho mỗi lệnh gọi

Khi bạn vượt quá giới hạn, API trả về HTTP 429. Mã lỗi cho bạn biết giới hạn nào: rate_limited nghĩa là quá nhiều yêu cầu mỗi phút, concurrency nghĩa là quá nhiều cùng lúc. Một quá tải tạm thời cũng trả về 429 và thêm Retry-After: 5. Curl có thể tự thử lại cho các lỗi tạm thời:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Ngoài ra, hãy giữ thân dưới 8 MB, điều này quan trọng nếu bạn gửi các tệp được mã hóa vào prompt.

Các yêu cầu thất bại hoặc bị từ chối không bị tính phí. Các yêu cầu thành công tuân theo một công thức đơn giản: $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra. Một lệnh gọi thử nghiệm với 40 token đầu vào và 120 token đầu ra tốn 40 / 1,000,000 x $0.15 = $0.000006 cộng 120 / 1,000,000 x $0.50 = $0.00006, vậy tổng cộng $0.000066. Một nghìn lệnh như vậy tốn $0.066.

Tín dụng trả trước không bao giờ hết hạn. Các khoản nạp tiền chạy từ $20 đến $500 theo số nguyên, kèm theo ưu đãi 5% từ $50, 10% từ $100 và 15% từ $200 bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Trang giá hiển thị chi tiết. Nếu một phản hồi trông sai, trang thực tế và hiểu lầm giải thích những gì mô hình có thể và không thể làm.

Hỏi đáp

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ộ thiết lập.

Token nằm ở đâu trong lệnh cURL?
    Trong header: -H "Authorization: Bearer YOUR_KEY". Thân yêu cầu cũng cần header Content-Type: application/json.
Tôi dùng tên mô hình nào?
    Dùng uncensored. Bạn có thể xác nhận bằng GET /v1/models.
Tại sao tôi nhận được 429?
    Bạn đã vượt quá giới hạn. Mã rate_limited nghĩa là quá nhiều yêu cầu mỗi phút, concurrency nghĩa là quá nhiều yêu cầu đồng thời. Hãy đợi vài giây hoặc giảm số lượng yêu cầu đồng thời.
Làm sao để xem số tín dụng còn lại?
    Mỗi phản hồi đều bao gồm tiêu đề X-Balance-USD. In tiêu đề bằng curl -i hoặc curl -D -.
Đây có phải là API chính thức của OpenAI không?
    Không. Đây là dịch vụ độc lập tương thích OpenAI, chạy một mô hình trọng số mở, nên các SDK và lệnh cURL được xây dựng cho định dạng OpenAI sẽ hoạt động sau khi thay đổi base URL và khóa API.