Uwierzytelnianie

OneProvider przyjmuje zarówno Bearer w stylu OpenAI, jak i x-api-key w stylu Anthropic. Podaj jedno z nich, nigdy oba.

Formy nagłówka

API przyjmuje dowolny z nagłówków. Użyj tego, który twoje SDK już wysyła.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Zmienne środowiskowe

W naszych przykładach klucz jest w ONEPROVIDER_KEY. Biblioteki SDK domyślnie same czytają jednak własne, natywne nazwy — wyeksportuj więc klucz pod taką nazwą albo przekaż ONEPROVIDER_KEY jawnie do konstruktora. Poniższa tabela pokazuje, co czyta każde narzędzie:

Sprawdzanie uwierzytelniania

Wywołaj /v1/models, aby wykonać tanie sprawdzenie bez skutków ubocznych:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Udana odpowiedź zawiera listę aktualnych modeli. Kod 401 oznacza tu, że klucz jest błędny, unieważniony albo jeszcze nieaktywny.

Gdzie trzymać klucz

• Zmienne środowiskowe — domyślny wybór w większości przypadków.
• ~/.zshrc / ~/.bashrc z ustawionym HISTCONTROL=ignorespace, aby polecenia poprzedzone spacją nie trafiały do historii powłoki.
• Menedżery sekretów: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• Pliki .env w poszczególnych projektach — zawsze w .gitignore.

Częste pułapki

• Ukośnik na końcu. https://api.oneprovider.dev/v1/ a https://api.oneprovider.dev/v1 — niektóre SDK łączą ścieżkę naiwnie. Używaj formy bez ukośnika na końcu, jak wyżej.
• Podwójny Bearer. Authorization: Bearer Bearer sk-... zdarza się, gdy narzędzie samo dodaje Bearer, a ty dodajesz go ponownie. Usuń prefiks w konfiguracji.
• Nagłówek wersji Anthropic. W surowych wywołaniach HTTP zawsze dodawaj anthropic-version: 2023-06-01. SDK dodają go za ciebie.

Rotacja kluczy

Utwórz nowy klucz w Panelu („Klucze” → „Utwórz klucz”), zaktualizuj go w swoich klientach, a potem usuń stary. Dzieje się to natychmiast i za darmo, a saldo jest wspólne dla wszystkich kluczy Panelu. Więcej: Panel i klucze .

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .