PL ▾

Jak sprawdzić klucz API AI za pomocą curl i Pythona

Klucz obracający się w zamku z trzema zielonymi lampkami, symbolizujący pomyślny test klucza API

Oto jak przetestować dostęp do klucza AI API bez budowania czegokolwiek: trzy wywołania, około dwie minuty, a będziesz wiedzieć, czy klucz jest ważny, doładowany i uprawniony do generowania tekstu.

Zaktualizowano

Kluczowe punkty

  • Najpierw wywołaj GET /v1/models: to potwierdza, że klucz jest akceptowany bez zużywania kredytu.
  • Wyślij jedno krótkie żądanie czatu do modelu uncensored, aby potwierdzić, że generowanie działa.
  • Odczytaj nagłówek X-Balance-USD lub GET /v1/balance, aby zobaczyć, co zostało.
  • 401 wskazuje na klucz, 402 na saldo, 429 na Twoje tempo wysyłania żądań.

Test trzema zapytaniami

Aby poprawnie przetestować klucz API AI, musisz udowodnić trzy oddzielne rzeczy: serwer akceptuje klucz, klucz ma za sobą kredyt i zwracana jest rzeczywista odpowiedź modelu. Jedno wywołanie na pytanie sprawia, że diagnostyka jest prosta. Jeśli coś się nie powiedzie, wiesz, która warstwa jest winna.

  1. Lista modeli. Autoryzuje klucz i nic nie kosztuje.
  2. Uzupełnienie czatu. Potwierdza, że model odpowiada i że format Twojego zapytania jest poprawny.
  3. Saldo. Potwierdza, co zostało po teście.

Wszystko poniżej używa bazowego URL https://api.aiapisource.com/v1 i ID modelu uncensored. Umieść swój klucz w zmiennej środowiskowej, aby nigdy nie trafił do historii powłoki ani repozytorium.

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

Jeśli jeszcze nie masz klucza, strona klucz API pokazuje, jak go utworzyć. Nowe konta mogą jednym kliknięciem zyskać darmowy kredyt próbny w wysokości $0,50, co w tym artykule wystarczy na wszystkie testy.

Krok 1: lista modeli za pomocą curl

Najtańszym sprawdzeniem jest zapytanie tylko do odczytu. GET /v1/models zwraca listę modeli i wymaga ważnego klucza, więc pomyślna odpowiedź dowodzi uwierzytelnienia.

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

Poprawna odpowiedź to JSON z tablicą data zawierającą uncensored. Jeśli widzisz stronę HTML, błąd połączenia lub pustą odpowiedź, problemem jest URL, a nie klucz. Upewnij się, że zachowałeś sufiks /v1 i że po kluczu w zmiennej nie ma spacji końcowych.

Dodaj -i do polecenia curl, aby zobaczyć nagłówki odpowiedzi. API wysyła X-Request-Id przy każdym zapytaniu. Zapisz tę wartość, jeśli skontaktujesz się z wsparciem, ponieważ identyfikuje ona konkretne zapytanie.

Krok 2: wyślij jedno zapytanie czatowe

Teraz sprawdź generowanie. Trzymaj prompt bardzo mały i ogranicz output, aby test kosztował ułamek centa.

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

Szukaj choices[0].message.content i obiektu usage z prompt_tokens oraz completion_tokens. Zapytanie o około 20 tokenach wejściowych i 5 wyjściowych kosztuje 20 / 1 000 000 x $0,15 plus 5 / 1 000 000 x $0,50, czyli około $0,0000055. Możesz wykonać sto takich testów za mniej niż cent.

Ten sam endpoint działa również ze strumieniowaniem: dodaj "stream": true, a tokeny przybędą jako zdarzenia wysyłane przez serwer. Przetestuj to osobno, gdy podstawowe zapytanie zadziała.

Krok 3: ten sam test w Pythonie

Jeśli Twój kod produkcyjny używa SDK OpenAI, przetestuj go również przez SDK. Wyłapuje problemy, których curl nie zauważy, np. przekazanie Base URL do niewłaściwego argumentu.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIAPI_KEY"],
    base_url="https://api.aiapisource.com/v1",
)

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

Pierwszy wydruk powinien wyświetlać listę zawierającą uncensored. Drugi wyświetla odpowiedź modelu. Dłuższy przewodnik dotyczący konfiguracji SDK znajdziesz w przewodniku po API Pythona OpenAI na tej stronie.

Uruchom wersję Pythona z tej samej powłoki, w której wyeksportowałeś klucz. Jeśli rzuci wyjątkiem KeyError dla AIAPI_KEY, zmienna nie jest ustawiona w tej sesji, co jest najczęstszą przyczyną niepowodzenia testu jeszcze przed dotarciem do sieci.

Node działa podobnie: przekaż baseURL: "https://api.aiapisource.com/v1" i klucz do konstruktora klienta OpenAI.

Sprawdź saldo

Klucz może być ważny, ale nie mieć środków do wydania. Dwa sposoby odczytania salda:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

Każda odpowiedź zawiera również nagłówek X-Balance-USD, więc wywołanie czatu z kroku 2 już poinformowało Cię o pozostałym kredycie, jeśli uruchomiłeś je z -i. W Pythonie SDK OpenAI udostępnia to przez client.chat.completions.with_raw_response.create(...), gdzie odczytujesz response.headers["X-Balance-USD"].

Nieudane lub odrzucone zapytania nie są rozliczane, więc test z błędem nie zużywa kredytu. Przedpłacony kredyt nie wygasa, więc nieużyte środki pozostaną dostępne również za tydzień.

Odczytywanie kodów błędów

Gdy test się nie powiedzie, kod statusu HTTP szybko zawęża przyczynę.

KodZnaczenieCo zrobić
401Klucz jest nieobecny, wpisany błędnie lub unieważnionySprawdź nagłówek Authorization: Bearer, skopiuj klucz ponownie, poszukaj ukrytych spacji lub cudzysłowów
402Brak środków na opłacenie żądaniaSprawdź stan konta, a następnie doładuj środki na stronie z cenami
404Nieprawidłowa ścieżka lub nieprawidłowy identyfikator modeluUżyj /v1/chat/completions i modelu uncensored
429Limit szybkości lub współbieżności, lub krótkotrwałe przeciążeniePoczekaj i spróbuj ponownie; zobacz poniżej

Kod 429 zawiera kod błędu. rate_limited oznacza zbyt wiele żądań na minutę, a concurrency oznacza zbyt wiele żądań wysłanych jednocześnie. Pełny klucz pozwala na 300 żądań na minutę i 8 żądań współbieżnych; klucz próbny pozwala na 60 żądań na minutę i 2 jednocześnie. Przy tymczasowym przeciążeniu API zwraca kod 429 z nagłówkiem Retry-After: 5, więc poczekaj pięć sekund i wyślij żądanie ponownie. Żądanie strumieniowane zajmuje slot współbieżności do momentu zakończenia strumienia, co jest częstą przyczyną osiągnięcia limitu przez klucz próbny podczas testów równoległych.

Kody stanu 401, 402 i 404 są zgodne z normalnymi konwencjami API, więc traktuj tabelę jako pierwsze przybliżenie i przeczytaj ciało błędu JSON dla dokładnej wiadomości.

Skrypt do ponownego testu

Po pomyślnym teście manualnym zachowaj skrypt, który możesz uruchomić po obróceniu kluczy lub zmianie środowiska.

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

Kod wyjścia ułatwia dodanie go do sprawdzania wdrożenia. Dla parametrów wykraczających poza to minimum, dokumentacja API wymienia wszystko, co endpoint akceptuje.

Pytania i odpowiedzi

Czy przetestowanie klucza API kosztuje?

Lista modeli jest darmowa. Krótkie zapytanie czatowe z niskim max_tokens kosztuje kilka milionowych części dolara przy cenie $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Nieudane zapytania nie są rozliczane.

Jak przetestować klucz bez karty?

Zdobądź darmowy kredyt próbny $0,50 na stronie klucza API po zalogowaniu się. Nie wymaga karty i jest ważny przez 7 dni, jeden na osobę.

Dlaczego ważny klucz zwraca 429 od razu?

Pewnie przekroczyłeś limit zapytań równoległych lub na minutę. Klucze próbne pozwalają na 2 równoległe zapytania i 60 na minutę; pełne klucze na 8 i 300. Sprawdź kod błędu, zwolnij lub spróbuj ponownie po kilku sekundach.

Czy mogę przetestować klucz w Postmanie lub aplikacji zamiast curl?

Tak. Działa dowolny klient kompatybilny z OpenAI: ustaw bazowy URL na https://api.aiapisource.com/v1, wklej klucz jako token Bearer i użyj modelu uncensored.

Twój klucz jest o jeden formularz stąd

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

Pobierz klucz API