PL ▾
Pobierz klucz API
API bez cenzury kompatybilne z OpenAI dla programistów.Zaktualizowano

Przykłady curl dla LLM API, które możesz skopiować i uruchomić

Jeśli chcesz przetestować LLM API za pomocą curl przed napisaniem kodu, poniższe żądania wystarczą. Każde z nich kieruje się do endpointu kompatybilnego z OpenAI, używa ID modelu uncensored i działa w zwykłym terminalu.

Panel terminalu wysyłający wiązkę światła do sześcianu serwera, reprezentujący żądanie curl do LLM API

Skonfiguruj powłokę i sprawdź endpoint

Pobierz klucz ze strony strony klucza API, a następnie wyeksportuj go wraz z bazowym URL, aby nie wklejać sekretów do każdego polecenia.

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

Każde zapytanie wysyła klucz jako token bearer w nagłówku Authorization. Treści żądań są w formacie JSON, więc dodaj Content-Type: application/json, gdy wysyłasz POST. Maksymalny rozmiar treści to 8 MB, co ma znaczenie tylko wtedy, gdy wklejasz bardzo duże dokumenty do promptu.

Przykłady używają pojedynczych cudzysłowów powłoki Unix. W PowerShell na Windows umieść JSON w pliku i przekaż go za pomocą --data @body.json, aby uniknąć problemów z cytowaniem.

Najtańszą kontrolą poprawności jest GET, który wypisuje modele. Potwierdza klucz i URL oraz nic nie kosztuje.

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

Tablica data w odpowiedzi powinna zawierać identyfikator uncensored. Kod 401 oznacza, że klucz jest nieobecny lub wpisany błędnie. Jeśli curl w ogóle nie może się połączyć, sprawdź host w $BASE i upewnij się, że kończy się na /v1 bez dodatkowej ścieżki.

1. Wyślij uzupełnienie rozmowy

To jest żądanie, które wysyła każdy klient kompatybilny z OpenAI pod spodem.

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

Odpowiedź jest w formacie JSON. Tekst znajduje się pod choices[0].message.content, a liczniki tokenów w usage. Przepuść wyjście przez jq -r '.choices[0].message.content', jeśli masz zainstalowany jq i chcesz tylko tekstu. Pole max_tokens jest opcjonalne; jeśli je pominiemy, uzupełnienie może wykorzystać pozostałą pojemność z okna 100 000 tokenów.

Dostępny jest również nowszy endpoint POST /v1/responses, jeśli Twój klient używa tego formatu. Pełną listę parametrów znajdziesz w dokumentacji.

2. Strumieniuj odpowiedź

Dodaj "stream": true i powiedz curlowi, aby nie buforował z -N. Tokeny będą drukowane po ich wygenerowaniu.

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

Każda linia zaczyna się od data: i zawiera mały fragment JSON z delta. Ostatnie zdarzenia zawierają zużycie, a strumień kończy się data: [DONE]. Bez -N curl czeka na pełny bufor, a wyjście wygląda, jakby przychodziło jednym kawałkiem. Pamiętaj, że żądanie strumieniowe zajmuje jedno miejsce w limicie współbieżności do końca.

3. Poproś o JSON

Dla wyjścia, które skrypt będzie parsował, włącz tryb JSON z response_format. Wspomnij słowo JSON w promptie, aby model wiedział, jakiego kształtu oczekujesz.

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'

Ostateczny filtr fromjson parsuje ciąg wewnątrz content, więc jq zgłosi błąd, jeśli model zwróci coś, co nie jest poprawnym JSON. To sprawia, że jest to przydatny szybki test. Więcej wzorców znajdziesz na stronie tryb JSON.

4. Wypróbuj wywołanie narzędzia

Wywoływanie narzędzi pozwala modelowi poprosić Twój kod o uruchomienie funkcji. Opisujesz funkcję w tablicy tools, a jeśli model zdecyduje się jej użyć, odpowiedź zawiera wpis tool_calls zamiast tekstu.

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'

Powinieneś otrzymać nazwę funkcji i ciąg JSON argumentów. Twój kod uruchamia funkcję, a następnie wysyła drugie zapytanie, które powtarza wcześniejsze wiadomości, dodaje wiadomość asystenta z wywołaniem narzędzia i dodaje wiadomość z role: "tool" zawierającą wynik. Model następnie pisze ostateczną odpowiedź.

5. Sprawdź nagłówki i saldo

Dodaj -i, aby zobaczyć nagłówki odpowiedzi wraz z treścią. Znajdziesz tam X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests i 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"

Drugie zapytanie zwraca Twój kredyt bezpośrednio. Narzędzia w stylu OpenAI mogą używać GET /v1/dashboard/billing/credit_grants zamiast tego. Małe zapytanie takie jak powyżej kosztuje ułamek centa: przy 10 tokenach wejściowych i 5 wyjściowych cena to 10 x 0,15 / 1 000 000 + 5 x 0,50 / 1 000 000 = $0,000004. Zobacz stronę z cenami, aby poznać stawki.

Ponownie używalny skrypt testu dymnego

Gdy zaufasz poszczególnym wywołaniom, opakuj je w krótki skrypt, który możesz uruchomić po każdym wdrożeniu, rotacji klucza lub zmianie sieci. Zawodzi przy pierwszym problemie, więc widzisz dokładnie, który krok się zepsuł.

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"

Flaga -f powoduje wyjście curla z błędem w przypadku niepowodzenia HTTP, a set -e zatrzymuje skrypt w tym miejscu. Dodaj to do zadania cron lub kroku CI, jeśli uruchamiasz usługę na tym API i chcesz wczesnego ostrzeżenia o zmianach. Przechowuj klucz w magazynie sekretów lub zmiennej środowiskowej, nigdy w pliku skryptu.

Gdy zmieniasz żądanie, zmieniaj jedną opcję na raz: temperature dla losowości, top_p dla próbkowania jądra, stop dla niestandardowych sekwencji zakończenia i seed dla powtarzalnego wyjścia. Wszystkie są przekazywane do modelu, więc możesz porównać ich wpływ z tej samej historii terminala.

Odczytywanie błędów z curl

KodPrawdopodobna przyczynaNaprawa
401Brakujący lub nieprawidłowy kluczSprawdź nagłówek Authorization i upewnij się, że $API_KEY jest wyeksportowany
400Nieprawidłowy JSON lub złe poleZweryfikuj treść za pomocą jq . przed wysłaniem
429, kod rate_limitedPonad 300 zapytań na minutę (60 na kluczu próbnym)Zwolnij pętlę
429, kod concurrencyWięcej niż 8 zapytań naraz (2 na kluczu próbnym)Uruchom mniej zadań równoległych
429 z Retry-After: 5Tymczasowe przeciążeniePoczekaj 5 sekund i ponów

Dodaj -w "\n%{http_code}\n", aby wydrukować kod stanu po treści, co oszczędza Ci zgadywania. Treści błędów są w formacie JSON z komunikatem i kodem, więc jq .error wyświetla je czysto. Jeśli widzisz 429 w pętli, nie próbuj ponownie natychmiast; pauza na kilka sekund pozwala na wyczyszczenie okna minutowego i miejsc współbieżności, a ścisła pętla ponownych prób tylko utrzymuje Cię powyżej limitu. Klucz próbny ma ściślejsze limity niż pełny klucz, więc skrypt, który działa po pierwszym doładowaniu, może nie zadziałać na kredycie próbnym, jeśli uruchamia zadania równolegle. Gdy żądania będą działać, przejdź do SDK; ten sam URL i nazwa modelu pozostają bez zmian. Nowe konta mogą uzyskać $0,50 kredytu próbnego jednym kliknięciem, wystarczająco na setki małych wywołań testowych. Doładowania po tym zaczynają się od $20 i są płatne w kryptowalutach (USDT na TRC20 lub USDC na Base).

Pytania i odpowiedzi

Pod jakim adresem URL wysyłam polecenia curl?

Użyj https://api.uncensoredllmapi.com/v1 jako podstawy, a następnie dodaj /chat/completions, /responses, /models lub /balance w zależności od tego, czego potrzebujesz.

Jak przetestować wywoływanie narzędzi za pomocą curl?

Dodaj tablicę tools z definicją funkcji do treści uzupełnienia czatu. Jeśli model zdecyduje się ją wywołać, odpowiedź zawiera tool_calls, a Ty wysyłasz wynik z powrotem jako wiadomość z role tool.

Dlaczego curl nic nie pokazuje, dopóki odpowiedź się nie zakończy?

Prawdopodobnie strumieniujesz bez flagi -N. Dodaj -N, aby curl wypisywał każdy fragment po jego otrzymaniu.

Czy nieudane zapytanie kosztuje pieniądze?

Nie. Nieudane lub odrzucone zapytania nie są rozliczane.

Twój klucz jest o jeden formularz stąd

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