Podstawowy URL API Mimo i sposób konfiguracji klientów

Wartości do skopiowania

Każdemu, kto szuka mimo api base url, potrzebne są trzy wartości, a wszystko inne to szczegóły narzędzia, które konfigurujesz.

Ustawienie	Wartość
Bazowy URL	https://api.mimoapi.top/v1
ID modelu	uncensored
Nagłówek Auth	Authorization: Bearer YOUR_KEY
Endpoint czatu	POST /v1/chat/completions
Lista modeli	GET /v1/models

Usługa jest kompatybilna z OpenAI, więc zadziała każdy klient, który pozwala na zmianę podstawowego URL OpenAI i klucza. To hostowany interfejs API tekstu obsługujący jeden model o otwartych wagach od niezależnego dostawcy; nie jest to oficjalne API żadnego dostawcy modeli. Tylko tekst: nie ma generowania obrazów, audio ani wideo, nie ma embeddingów ani dostrajania, więc klienci oczekujący tych endpointów ich nie znajdą. Jeśli jeszcze nie masz klucza, strona klucza zajmie Ci minutę.

Podstawowy URL versus pełny endpoint

Najczęstszy błąd to mylenie podstawowego URL z URL endpointu. Podstawowy URL kończy się na /v1. Endpoint to podstawowy URL plus ścieżka. Oficjalne SDK OpenAI i większość narzędzi na nich opartych łączy je za Ciebie.

• Podstawowy URL: https://api.mimoapi.top/v1
• Endpoint czatu: https://api.mimoapi.top/v1/chat/completions
• Endpoint modeli: https://api.mimoapi.top/v1/models

Gdy ekran ustawień pyta o „podstawowy URL”, „bazę API”, „endpoint” lub „host”, przeczytaj podpowiedź. Jeśli podpowiedź kończy się na /v1, wklej podstawowy URL. Jeśli kończy się na /chat/completions, wklej pełny endpoint czatu. Wklejenie pełnego endpointa w pole oczekujące podstawowego URLa daje /chat/completions/chat/completions, którego nie ma. Wklejenie samej domeny w pole oczekujące podstawowego URLa daje /chat/completions bez /v1, co kończy się tym samym błędem.

Zwróć też uwagę na host. API działa na subdomenie api. Zwykła domena strony służy do wyświetlania stron internetowych, więc zapytanie do niej z ścieżką API nie dotrze do modelu.

Python i Node

W oficjalnych SDK ustawiasz podstawowy URL raz podczas tworzenia klienta. Zainstaluj je przez pip install openai lub npm install openai.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Name three uses for a base URL."}],
    max_tokens=150,
)
print(resp.choices[0].message.content)

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mimoapi.top/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
  max_tokens: 150,
});
console.log(resp.choices[0].message.content);

SDK Python i Node OpenAI odczytują też zmienne środowiskowe OPENAI_BASE_URL i OPENAI_API_KEY, jeśli nie przekażesz wartości w kodzie. To pozwala przekierować istniejący skrypt bez jego edycji: wyeksportuj obie zmienne, a skrypt będzie rozmawiać z tym API. Upewnij się, że skrypt nie ma na sztywno zdefiniowanego modelu, np. nazwy GPT; zamień go na uncensored.

curl do szybkiego testu

Zwykłe wywołanie HTTP usuwa wszystkie inne zmienne, więc jest to najlepsze pierwsze sprawdzenie. Pierwsza komenda wypisuje modele i potwierdza klucz. Druga wysyła zapytanie czatu.

Copyexport LLM_API_KEY="YOUR_KEY"

curl -s https://api.mimoapi.top/v1/models \
  -H "Authorization: Bearer $LLM_API_KEY"

curl -s https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i

Flaga -i wypisuje nagłówki odpowiedzi. Szukaj X-Request-Id (podaj go w kontakcie z pomocą techniczną), X-Balance-USD (twój pozostały kredyt) oraz dwóch nagłówków limitu zapytań, X-RateLimit-Limit-Requests i X-RateLimit-Limit-Concurrency. Przy strumieniowaniu dodaj "stream": true do ciała żądania i -N do curla, aby wyjście nie było buforowane. Szybki start w pięć minut przeprowadzi cię przez strumieniowanie i wywoływanie funkcji.

LangChain, interfejsy czatu i inne narzędzia

Narzędzia zewnętrzne używają własnych etykiet, ale wszystkie potrzebują tych samych trzech wartości. Zobaczysz pewne wzorce:

• LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). Ta sama klasa działa dla dowolnego serwera kompatybilnego z OpenAI.
• SillyTavern i podobne interfejsy do odgrywania ról: wybierz niestandardowe lub ogólne źródło czatu kompatybilne z OpenAI, wklej podstawowy URL, dodaj klucz i wpisz uncensored jako nazwę modelu, jeśli lista nie wypełni się sama.
• Open WebUI i inne samodzielnie hostowane interfejsy czatu: dodaj połączenie kompatybilne z OpenAI w ustawieniach, używając tego samego podstawowego URL i klucza.
• Wtyczki edytorów i skrypty: szukaj opcji „niestandardowy endpoint OpenAI” lub „nadpisz podstawowy URL” w ustawieniach wtyczki.

Nazwy menu w każdym narzędziu zmieniają się między wersjami, więc polegaj na przeznaczeniu pola, a nie na dokładnej etykiecie. Jeśli narzędzie upiera się przy sprawdzaniu klucza względem ustalonego dostawcy, nie jest kompatybilne z niestandardowymi endpointami i rozwiązaniem jest inne narzędzie.

Gdy narzędzie oferuje listę rozwijaną modeli, zwykle wypełnia ją wywołując GET /v1/models. Jeśli lista jest pusta, wpisz ID modelu ręcznie. Jeśli narzędzie odrzuca nieznane nazwy modeli, szukaj opcji oznaczonej „niestandardowy model”.

Naprawianie typowych błędów konfiguracji

Gdy zapytanie się nie powiedzie, kod statusu i dokładny URL szybko zawężają przyczynę. Przejdź przez tę listę.

1. Błąd uwierzytelnienia. Klucz jest nieobecny, ucięty lub ma spację lub znak nowej linii na końcu. Wklej go ponownie i upewnij się, że nagłówek brzmi Bearer, spacja, a potem klucz.
2. Nie znaleziono. Ścieżka jest błędna. Wypisz końcowy URL, który buduje Twój klient. Powinien to być dokładnie https://api.mimoapi.top/v1/chat/completions. Szukaj brakującego /v1, zduplikowanej ścieżki lub błędnego hosta.
3. Nieznany model. Pozostała nazwa modelu z innego dostawcy. Ustaw model na uncensored.
4. HTTP 429 z rate_limited lub concurrency. Przekraczasz 300 zapytań na minutę lub 8 jednocześnie (60 i 2 na kluczu próbnym). Zwolnij lub ustaw zapytania w kolejce. 429 z nagłówkiem Retry-After: 5 oznacza tymczasowe przeciążenie; poczekaj pięć sekund i spróbuj ponownie.
5. Zapytanie za duże. Limit rozmiaru treści żądania to 8 MB, a okno kontekstu to 100 000 tokenów dla promptu plus completion. Skróć historię.
6. Działa w curl, nie działa w przeglądarce. Wywołanie API bezpośrednio z JavaScriptu frontendu wystawia Twój klucz dla każdego odwiedzającego. Przekieruj wywołania przez własny serwer.

Nigdy nie umieszczaj klucza w publicznym repozytorium ani w pakiecie klienckim. Przechowuj go w zmiennej środowiskowej i trzymaj go z dala od zrzutów ekranu i zgłoszeń do supportu.

Kolejne kroki po pierwszym udanym wywołaniu

Gdy podstawowy URL działa, warto znać kilka ustawień. Strumieniowanie przez SSE włącza się przez stream: true. Wywoływanie funkcji używa tools i tool_choice, z wynikami wysyłanymi jako komunikaty role: "tool". Tryb JSON to response_format: {"type": "json_object"}. Sterowanie próbkowaniem takie jak temperature, top_p, stop, seed i kary są przekazywane dalej.

Pod względem kosztów płacisz $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych z przedpłaconego kredytu; na stronie z cenami znajdziesz listę kwot doładowań i bonusów. Model jest dostrojony do odpowiadania bez odrzucania treści dla legalnego użytku przez dorosłych, a treści seksualne z udziałem nieletnich są zawsze zabronione. Prompty nie są używane do trenowania.

Więcej przewodników

• Ceny API Mimo: Stawki za tokeny w modelu prepaid
• Klucz API Mimo: Utwórz go i wykonaj zapytanie
• Alternatywy dla Mistral API: Porównanie opcji LLM bez cenzury