Utwórz klucz w pięciu krokach
Aby uzyskać klucz API Mimo dla tej usługi, wykonaj poniższe kroki. Do tego nie potrzebujesz karty ani połączenia telefonicznego.
- Zarejestruj się. Użyj konta Google lub zarejestruj się pod adresem e-mail z hasłem.
- Otwórz stronę klucza. Po rejestracji przejdź do strony klucza API. Twój klucz zostanie tam wyświetlony.
- Odbierz kredyt próbny. Nowi użytkownicy mogą jednym kliknięciem odebrać kredyt próbny $0,50 na tej stronie. Kredyt jest ważny przez 7 dni, nie wymaga karty i jest przydzielany raz na osobę.
- Skopiuj klucz i przechowuj go w bezpiecznym miejscu, np. w menedżerze haseł lub zmiennej środowiskowej.
- Wyślij zapytanie testowe za pomocą polecenia curl z następnej sekcji.
Usługa to hostowany, kompatybilny z OpenAI interfejs API tekstowy. Działa na jednym modelu o otwartych wagach od niezależnego dostawcy, dostrojonym do odpowiadania bez odmów dotyczących treści, do zgodnego z prawem użytku przez dorosłych. Nie jest to oficjalny interfejs API żadnego dostawcy modeli. Twój klucz działa z tym jednym modelem, którego identyfikator to uncensored, pod bazowym adresem URL https://api.mimoapi.top/v1.
Przetestuj klucz jednym zapytaniem
Wykonaj test w terminalu przed podłączeniem klucza do aplikacji. Jeśli test się nie powiedzie, problem dotyczy klucza lub konta, więc nie musisz szukać błędów we własnym kodzie.
export LLM_API_KEY="paste-your-key-here"
curl -i 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": "Write one sentence about keys."}],
"max_tokens": 60
}'
Poprawny wynik to status 200 i ciało JSON z tablicą choices. Nagłówki zawierają X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests oraz X-RateLimit-Limit-Concurrency. Nagłówek salda to szybki sposób na sprawdzenie kosztu zapytania: wykonaj go dwukrotnie i porównaj wyniki. Jeśli chcesz tylko potwierdzić ważność klucza bez ponoszenia kosztów, wywołaj GET /v1/models z tym samym nagłówkiem.
To samo zapytanie w Pythonie, przy użyciu oficjalnego pakietu OpenAI:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one sentence about keys."}],
max_tokens=60,
)
print(resp.choices[0].message.content)Co może i nie może robić klucz próbny
Kredyt próbny służy do testów, a nie do produkcji. Klucz próbny pozwala na 2 równoległe zapytania i 60 zapytań na minutę, z czasem ważności 7 dni. Pełny klucz, który otrzymujesz po doładowaniu kredytu, pozwala na 8 równoległych zapytań i 300 na minutę. Oba dzielą ten sam model, to samo okno kontekstu 100 000 tokenów i te same funkcje: strumieniowanie przez SSE, wywoływanie funkcji, tryb JSON oraz standardowe parametry próbkowania.
Na ile starczy $0,50? Przy cenie $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych, zapytanie z 1000 tokenami wejściowymi i 300 tokenami wyjściowymi kosztuje 1000 x $0,15 / 1 000 000 = $0,00015 za dane wejściowe plus 300 x $0,50 / 1 000 000 = $0,00015 za dane wyjściowe, co daje łącznie $0,0003. Kredyt próbny pokrywa około 1666 zapytań o takim rozmiarze ($0,50 / $0,0003). To wystarczy do przetestowania promptów, zbudowania prototypu i wypróbowania strumieniowania lub narzędzi.
Wykorzystaj kredyt próbny do pomiarów. Wybierz pięć promptów, które Twoja aplikacja będzie wysyłać najczęściej, uruchom każde kilka razy i zanotuj zmianę salda. Pod koniec tygodnia będziesz znać rzeczywisty koszt jednego zapytania i sposób, w jaki model zachowuje się na Twoich danych. Zapytania nieudane lub odrzucone nie są rozliczane.
Chroń prywatność klucza
Klucz API to hasło, które również zużywa środki. Każdy, kto go posiada, może wysyłać zapytania na Twój koszt. Kilka zasad zapobiega większości wycieków:
- Zmienne środowiskowe, nie pliki źródłowe. Odczytaj klucz za pomocą
os.environlubprocess.env. Do pracy lokalnej wystarczy plik.envumieszczony w.gitignore. - Tylko po stronie serwera. Nie wywołuj API z JavaScript w przeglądarce ani w aplikacji mobilnej, ponieważ każdy może odczytać klucz ze strony lub pakietu aplikacji. Umieść mały serwer pośredniczący między frontendem a API.
- Jedno miejsce na klucz. Przechowuj klucz w jednym magazynie sekretów i kopiuj go stamtąd do każdego wdrożenia, aby zawsze wiedzieć, gdzie się znajduje.
- Brak kluczy w czacie, zgłoszeniach czy zrzutach ekranu. Prosząc o pomoc, udostępnij
X-Request-Idz odpowiedzi, a nie sam klucz. - Zamień przy podejrzeniu. Jeśli sądzisz, że klucz został ujawniony, przestań go używać i skontaktuj się z pomocą techniczną w celu jego wymiany.
Obserwuj również nagłówek X-Balance-USD. Spadek salda, gdy Twoja aplikacja jest bezczynna, jest pierwszym znakiem, że ktoś inny używa Twojego klucza.
Wyjdź poza fazę próbną: doładuj i płac
Gdy kredyt próbny się wyczerpie, doładuj konto. Możesz doładować dowolną kwotę całkowitą od $20 do $500. Bonusy są dodawane automatycznie: 5% od $50, 10% od $100 i 15% od $200. Doładowanie na $100 daje więc $110 kredytu, a na $200 daje $230. Możesz zapłacić kryptowalutami (USDT w sieci TRC20, USDC na Base).
Nie ma subskrypcji. Płacisz za tokeny z salda, a kredyt nie wygasa, co pasuje do projektów o nierównym ruchu. Pełna lista cen znajduje się na stronie z cenami. Prompty wysłane przez API nie są używane do trenowania.
Rozsądnym pierwszym doładowaniem jest $20. Przy zapytaniu o rozmiarze czatu użytym wcześniej na tej stronie ($0,0003 za każde), pokrywa ono około 66 000 zapytań. Sprawdź swój średni koszt po kilku dniach i dostosuj kwotę.
Rozwiązywanie problemów z działaniem klucza
Większość problemów z kluczem ma proste przyczyny.
- Błąd uwierzytelnienia od razu. Podczas kopiowania zgubił się lub dodał się jakiś znak. Szukaj spacji na początku lub końcu, lub znaku końca linii. Sprawdź, czy nagłówek ma postać
Authorization: Bearer, po którym następuje klucz. - Działa w curl, ale nie w Twojej aplikacji. Aplikacja prawdopodobnie nie odczytuje zmiennej środowiskowej. Wypisz pierwsze cztery znaki wartości, którą widzi aplikacja, a nie cały klucz.
- Nie znaleziono. Bazowy adres URL jest błędny. Musi to być
https://api.mimoapi.top/v1na poddomenieapi. Na stronie szybkiego startu znajdziesz listę klientów. - HTTP 429. Kod
concurrencyoznacza zbyt wiele żądań jednocześnie;rate_limitedoznacza zbyt wiele na minutę. Klucze próbne osiągają ten limit szybciej (2 jednocześnie, 60 na minutę). Kod 429 zRetry-After: 5oznacza krótkotrwałe przeciążenie; poczekaj pięć sekund. - Brak kredytu próbnego. Kredyt próbny odbiera się kliknięciem na stronie kluczy i przysługuje raz na osobę. Wygasa po 7 dniach.
Jeśli to nie pomoże, zbierz wartość X-Request-Id z nieudanej odpowiedzi i skontaktuj się z pomocą techniczną. To ID pozwala zlokalizować problem bez udostępniania klucza.
Co zbudować jako pierwsze
Posiadając działający klucz, wybierz mały projekt wykorzystujący funkcje, których będziesz potrzebować później. Pętla czatu wiersza poleceń uczy historii wiadomości. Skrypt zwracający obiekt JSON z response_format uczy formatu danych. Funkcja, którą model może wywołać, uczy korzystania z narzędzi. Każda z nich zajmuje mniej niż godzinę i każda działa na saldzie kredytu próbnego. Jeśli rozważasz tę usługę w porównaniu do innych hostowanych modeli, porównanie w artykule Alternatywy dla API Mistral wymienia pytania, które warto zadać przed podjęciem decyzji.
Korzystaj z usługi zgodnie z prawem i wyłącznie jako osoba dorosła. Model jest dostrojony do odpowiadania bez odmów dotyczących treści, co jest zaletą w przypadku fikcji, odgrywania ról i badań, ale nie daje zgody na łamanie zasad: treści seksualne z udziałem nieletnich są zawsze zabronione.
