PL ▾
Pobierz klucz API

API w stylu OpenAI z cURL i tokenem Bearer

Aby wywołać API w stylu OpenAI z linii poleceń, wyślij żądanie HTTP POST z nagłówkiem Authorization zawierającym Twój token. Ta strona zawiera działające polecenia cURL dla każdej funkcji tego API oraz kroki diagnostyczne w przypadku błędów.

Zaktualizowano

Okno terminala wysyłające klucz i pakiety danych wzdłuż świetlistego kabla do serwera

Kluczowe punkty

  • Token umieszczasz w nagłówku Authorization: Bearer TWOJ_KLUCZ, a identyfikator modelu to uncensored.
  • Istnieją dwa endpointy: GET /v1/models oraz POST /v1/chat/completions.
  • Dodaj -N i ustaw stream true, aby zobaczyć przychodzące tokeny poprzez zdarzenia wysyłane przez serwer.
  • Przeczytaj nagłówki X-Balance-USD oraz limity zapytań poleceniem curl -i; kod 429 oznacza, że musisz poczekać i ponowić próbę.

Minimalne zapytanie

Oto najkrótsza metoda wykonania open ai api curl z tokenem dla tej usługi. Ustaw klucz w zmiennej środowiskowej, aby nie trafił do historii powłoki, a następnie wyślij wiadomość czatu:

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."}
    ]
  }'

Odpowiedź to JSON w formacie completion czatu OpenAI. Odpowiedź znajduje się w choices[0].message.content, a obiekt usage raportuje tokeny promptu i uzupełnienia. Każda część polecenia pełni określoną funkcję:

  • Authorization: Bearer ... zawiera token. Bearer to nazwa schematu; każdy, kto posiada token, jest traktowany jako jego właściciel, dlatego nie należy go przechowywać w publicznych repozytoriach.
  • Content-Type: application/json informuje serwer, jak odczytać ciało żądania. Bez tego żądanie często kończy się błędem parsowania.
  • model musi mieć wartość uncensored, czyli jedyny model obsługiwany przez to API.
  • messages to lista obiektów z polem role (system, user, assistant lub tool) oraz content.

Aby uzyskać klucz, zarejestruj się za pomocą Google lub e-maila i hasła, a następnie przejdź do strony klucza API. Nowi użytkownicy mogą jednym kliknięciem uzyskać $0,50 kredytu próbnego: bez karty, ważny przez 7 dni, jeden na osobę.

Sprawdź klucz za pomocą GET /v1/models

Zanim zaczniesz debugować długie zapytanie, potwierdź działanie klucza najtańszym możliwym wywołaniem. Wylistowanie modeli jest darmowe i pokaże, czy URL, nagłówek i klucz są poprawne.

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

Poprawna odpowiedź to lista JSON zawierająca uncensored. Jeśli masz zainstalowany jq, przekaż wynik do potoku, aby wyodrębnić tylko ID:

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

Jeśli nie otrzymasz użytecznych danych, przejdź przez poniższą listę kolejno, ponieważ przyczyny wymieniono według częstotliwości występowania:

  1. Zmienna jest pusta. Uruchom echo "${UF_KEY:0:6}", aby zobaczyć pierwsze znaki bez wypisywania całego klucza.
  2. W nagłówku jest literówka lub brakuje słowa "Bearer" przed kluczem.
  3. Zakręcone cudzysłowy z dokumentu lub klienta czatu zastąpiły proste cudzysłowy w poleceniu.
  4. Base URL jest błędny. Powinien to być https://api.unfilteredaimodels.com/v1, z prefiksem api. i sufiksem /v1.
  5. Klucz został skopiowany z spacją lub znakiem nowej linii na końcu.

Przeczytaj nagłówki odpowiedzi

Dodaj -i, aby uwzględnić nagłówki w wyjściu, lub -D -, aby je wydrukować, zachowując ciało odpowiedzi:

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"}]}'

Warto znać cztery nagłówki odpowiedzi:

NagłówekZnaczenie
X-Request-IdIdentyfikator tego żądania. Podaj go, jeśli skontaktujesz się z pomocą techniczną.
X-Balance-USDTwój pozostały przedpłacony kredyt.
X-RateLimit-Limit-RequestsDozwolona liczba zapytań na minutę dla Twojego klucza.
X-RateLimit-Limit-ConcurrencyDozwolona liczba żądań równoległych dla Twojego klucza.

Limity to 300 zapytań na minutę i 8 żądań równoległych dla pełnego klucza oraz 60 na minutę i 2 równoległe dla klucza próbnego. Powyższe żądanie ustawia max_tokens na 5, aby test był mały. W normalnym użyciu max_tokens jest opcjonalne, a uzupełnienie może wykorzystać dowolną liczbę tokenów z okna 100 000 po Twoim promptcie.

Strumieniowanie z linii poleceń

Ustaw "stream": true i dodaj -N, aby curl nie buforował wyjścia. Zobaczysz linie zaczynające się od data:, każda z małym delta JSON, oraz końcowe data: [DONE]. Przed nim znajduje się fragment z użyciem tokenów.

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."}]
  }'

Aby wydrukować tylko tekst, przefiltruj strumień krótkim potokiem:

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

Żądanie strumieniowe zajmuje slot równoległości do momentu zakończenia strumienia. Jeśli uruchomisz wiele strumieni równolegle ze skryptu i zapomnisz poczekać na ich zakończenie, trafisz na limit równoległości, mimo niskiej częstotliwości zapytań.

Tryb JSON i wywoływanie narzędzi

Tryb JSON sprawia, że model zwraca jeden poprawny obiekt JSON. Określ pożądaną strukturę w promptcie, inaczej klucze będą takie, jakie wybierze model.

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'

Wywoływanie funkcji korzysta ze standardowych pól tools i tool_choice. Model odpowiada tablicą tool_calls zamiast tekstu; wywołujesz funkcję samodzielnie i zwracasz wynik jako wiadomość z role: "tool" oraz pasującym tool_call_id.

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?"}]
  }'

W odpowiedzi wyszukaj choices[0].message.tool_calls[0].function.arguments. Jest to ciąg JSON do przeanalizowania, wywołania Twojej własnej funkcji pogodowej i zwrócenia w kolejnym zapytaniu. Parametry takie jak temperature, top_p, stop, seed oraz kary są przekazywane dalej. Dokumentacja wymienia wszystkie obsługiwane pola.

Chroń token i porządkuj polecenia

Token Bearer to hasło o innej nazwie. Każdy, kto go ma, może wydać Twój kredyt, więc traktuj go ostrożnie. Nigdy nie wklejaj prawdziwego klucza do publicznego issue, zrzutu ekranu ani dziennika terminala. Jeśli podejrzewasz wyciek, wygeneruj ponownie klucz ze strony kluczy i zaktualizuj skrypty.

Historia powłoki to najczęstsza przyczyna wycieków na komputerze osobistym. Wpisanie klucza bezpośrednio do polecenia zapisuje go w pliku historii. Ustawienie go raz przez export też zapisuje tę linię. Dwie czystsze metody to: odczyt klucza z pliku dostępnego tylko dla Ciebie lub poprzedzenie polecenia spacją, jeśli powłoka ignoruje linie zaczynające się od spacji. Mały plik sprawdzi się dobrze:

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)"

Długie ciała JSON trudno czytać w pojedynczych cudzysłowach, a cytowanie psuje się, gdy prompt zawiera apostrof. Umieść ciało w pliku i niech curl odczyta je przez -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'

Ta sama metoda pozwala utrzymać duże prompty w granicach limitu 8 MB, a plik można wersjonować w git, podczas gdy klucz pozostaje poza repozytorium. W PowerShell na Windowsie pojedyncze cudzysłowy wokół JSON zachowują się inaczej, a kontynuacja wiersza znakiem backslash nie istnieje; forma -d @request.json rozwiązuje oba problemy, a do kontynuacji polecenia możesz użyć backtick na końcu linii.

Po zakończeniu testów przejdź na SDK. Biblioteki OpenAI Python i Node akceptują ten sam Base URL i klucz, obsługują za Ciebie ponowne próby i strumieniowanie oraz zwracają ten sam format odpowiedzi, który parsowałeś ręcznie. Polecenia cURL pozostają najszybszym sposobem sprawdzenia, czy błąd wynika z Twojego kodu, czy z samego żądania, więc zachowaj znane dobre polecenie w notatkach. Przy zgłaszaniu problemu do pomocy technicznej dołącz X-Request-Id nieudanego wywołania i dokładny kod statusu; ta para pozwala znaleźć żądanie bez powtarzania testu i oszczędza wymianę wiadomości.

Błędy, ponowne próby i koszt wywołania

Po przekroczeniu limitu API zwraca HTTP 429. Kod błędu informuje, który limit: rate_limited oznacza zbyt wiele zapytań na minutę, concurrency oznacza zbyt wiele naraz. Tymczasowe przeciążenie też zwraca 429 i dodaje Retry-After: 5. Curl może automatycznie ponowić próbę przy błędach tymczasowych:

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"}]}'

Utrzymuj też ciało poniżej 8 MB, co ma znaczenie przy przesyłaniu plików zakodowanych w promptcie.

Nieudane lub odrzucone żądania nie są rozliczane. Pomyślne podlegają prostemu wzorowi: $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych. Wywołanie testowe z 40 tokenami wejściowymi i 120 wyjściowymi kosztuje 40 / 1 000 000 x $0,15 = $0,000006 plus 120 / 1 000 000 x $0,50 = $0,00006, czyli łącznie $0,000066. Tysiąc takich wywołań to $0,066.

Kredyt jest przedpłacony i nie wygasa. Doładowania wynoszą od $20 do $500 w całości, z bonusem 5% od $50, 10% od $100 i 15% od $200, za pomocą kryptowalut (USDT w TRC20, USDC na Base). Strona cennika zawiera szczegółowe informacje. Jeśli odpowiedź wydaje się błędna, strona mity i fakty wyjaśnia, co model potrafi, a czego nie.

Pytania i odpowiedzi

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Gdzie umieścić token w poleceniu cURL?
    W nagłówku: -H "Authorization: Bearer YOUR_KEY". W ciele żądania należy również dodać nagłówek Content-Type: application/json.
Jakiej nazwy modelu użyć?
    Użyj uncensored. Możesz to potwierdzić komendą GET /v1/models.
Dlaczego otrzymuję błąd 429?
    Przekroczyłeś limit. Kod rate_limited oznacza zbyt wiele zapytań na minutę, concurrency oznacza zbyt wiele naraz. Poczekaj kilka sekund lub zmniejsz liczbę równoległych wywołań.
Jak sprawdzić pozostały kredyt?
    Każda odpowiedź zawiera nagłówek X-Balance-USD. Wyświetl nagłówki poleceniem curl -i lub curl -D -.
Czy to oficjalne API OpenAI?
    Nie. To niezależna usługa kompatybilna z OpenAI, która obsługuje jeden model o otwartych wagach, więc SDK i polecenia cURL przeznaczone dla formatu OpenAI zadziałają po zmianie Base URL i klucza API.