Migracja z OpenAI

Różnica to trzy linijki. Twoje obecne SDK OpenAI nadal działa.

Zmiana w kodzie

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

Wybierz według zastosowania

Nie wymyślamy odpowiedników „jeden do jednego” między nazwami modeli różnych dostawców. Wybierz aktualny poziom GPT według wymagań co do jakości, kosztu i opóźnienia:

Co działa bez zmian

• chat.completions.create z messages, temperature, max_tokens, stream.
• Wywoływanie funkcji przez tools; tool_choice: "auto".
• Tryb JSON (response_format: {"type": "json_object"}).
• Streaming przez iteratory asynchroniczne zarówno w Pythonie, jak i w Node.

Co się zmienia

• seed i logprobs są po cichu ignorowane.
• Zwracane identyfikatory mają prefiks chatcmpl-op- zamiast chatcmpl-.
• Dawny kształt function_call jest wewnętrznie mapowany na tool_use Anthropic; wygląd odpowiedzi się nie zmienia.

Korzystanie z Codex CLI od OpenAI

Jeśli używasz Codex CLI od OpenAI, skieruj go na nasz endpoint Responses API i użyj tego samego klucza. Pełna konfiguracja jest na stronie klienta Codex — w skrócie: ~/.codex/auth.json na klucz, ~/.codex/config.toml z base_url = "https://api.oneprovider.dev/v1" i wire_api = "responses".

Kontrola po migracji

response = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

Przejście z OpenRouter lub innej bramy API

Co zmienia się w moim kliencie?

Trzy ustawienia: base URL, klucz i identyfikator modelu. SDK OpenAI i narzędzia zgodne z OpenAI używają https://api.oneprovider.dev/v1; Claude Code i SDK Anthropic używają https://api.oneprovider.dev. Jeden klucz OneProvider działa przy obu.

Czym różnią się identyfikatory modeli?

Identyfikatory OneProvider nie mają prefiksu dostawcy, na przykład claude-sonnet-5-5 lub gpt-6.1-terra. Skopiuj je ze strony modeli : nieznany identyfikator zwraca błąd 400 z nazwą problemu.

Co dodaje OneProvider?

Natywne endpointy Anthropic i zgodne z OpenAI pod jednym kluczem, przedpłacone saldo, które nie wygasa i nie wymaga subskrypcji, doładowania kryptowalutami, kartą, Apple Pay, Google Pay lub SBP, limit wydatków i termin ważności dla każdego klucza oraz dziennik zużycia każdego żądania. Zgodnie z polityką treść promptów nie jest przechowywana; serwery są we Frankfurcie.

Jak porównać koszt?

Porównuj ten sam model: stawki za milion tokenów, w tym stawki cache, są na stronie z cennikiem . Potem uruchom prawdziwe zadanie i sprawdź naliczoną kwotę w dzienniku zużycia.

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 .