Szybki start: Podłącz swojego klienta

Wymagania wstępne i instalacja SDK

Zainstaluj oficjalne SDK dla swojego języka, aby automatycznie obsługiwać uwierzytelnianie i serializację żądań. Potrzebujesz ważnego klucza API oraz skonfigurowanego adresu URL bazowego w środowisku klienta. Nasza usługa akceptuje standardowe parametry, takie jak temperatura i top_p, bez konieczności używania niestandardowych nagłówków.

Upewnij się, że zmienna środowiskowa przechowuje Twój token bezpiecznie przed uruchomieniem dowolnych skryptów. Wersje SDK muszą być aktualne, aby poprawnie obsługiwać funkcje strumieniowania i trybu JSON. Nie są wymagane dodatkowe sterowniki do generowania tylko tekstu.

Konfigurowanie bazowego adresu URL i klucza

Wskaż klienta na nasz konkretny adres bazowy, aby kierować żądania przez naszą infrastrukturę bez cenzury. Użyj nagłówka Authorization: Bearer YOUR_KEY do uwierzytelniania każdego wywołania. To rozwiązanie działa identycznie zarówno do testów lokalnych, jak i skryptów wdrożeniowych.

Zastandardowy endpoint OpenAI naszym hostem, aby uniknąć pomyłek z innymi dostawcami. Chroń swój klucz w tajemnicy i nie wystawiaj go w publicznych repozytoriach. Konfiguracja pozostaje statyczna do momentu rotacji klucza.

Wysyłanie pierwszej prośby

Wykonaj standardowe wywołanie uzupełnień czatu, aby zweryfikować łączność i format odpowiedzi. Wyś prosty prompt, aby potwierdzić, że model zwraca tekst bez odmów. Test ten zapewnia, że Twój klucz ma wystarczające kredyt z góry opłacony do użytku.

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

Sprawdź odpowiedź pod kątem szczegółów dotyczących treści i zużycia tokenów. Jeśli otrzymasz błąd 401, zweryfikuj format swojego klucza. Błąd 402 oznacza, że musisz doładować saldo kredytu.

Obsługa odpowiedzi strumieniowych

Włącz strumieniowanie, aby otrzymywać tokeny w czasie rzeczywistym, gdy są generowane. Zmniejsza to postrzeganą opóźnienie dla użytkowników oczekujących na długie wyjścia. Ostatni fragment zawiera końcowe liczby tokenów dla dokładności rozliczeń.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Obsłuż częściowe odpowiedzi z gracją w kodzie klienta. Buforuj treść, aż strumień się zamknie lub wystąpi błąd. Strumieniowanie działa ze wszystkimi standardowymi parametrami, w tym z regulacją temperatury.

Integracja SDK Python

Użyj biblioteki Python do zarządzania żądaniami przy minimalnym kodzie boilerplate. Zainicjuj klienta, podając base URL i klucz, aby rozpocząć pracę natychmiast. Podejście to upraszcza obsługę błędów i parsowanie odpowiedzi.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Skorzystaj z wygenerowanej treści bezpośrednio z obiektu odpowiedzi. Sprawdź błędy i odpowiednio obsłuż limity szybkości. SDK obsługuje zarówno przepływy pracy synchroniczne, jak i asynchroniczne.

SDK Node i limity

Zintegruj się z aplikacjami Node.js, korzystając z oficjalnego SDK JavaScript. Ustaw bazowy adres URL, aby zapewnić dotarcie żądań do naszego endpointu uncensored. Monitoruj swoje zużycie, aby mieścić się w limitach szybkości.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapiminimax.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Możesz wysyłać 300 żądań na minutę z współbieżnością 8. Każde ciało żądania musi mieścić się w limicie 8 MB. Okno kontekstowe obsługuje łącznie 100,000 tokenów. Błędy i odrzucenia nie zużywają kredytu, ale pomyślne wyjścia tak. Chroń swój klucz i obróć go, jeśli jest to konieczne.

Zrozumienie zużycia tokenów

Rozliczenia opierają się na rzeczywistych tokenach użytych w promptcie i completion. Tokeny input kosztują $0.15 za milion, podczas gdy tokeny output kosztują $0.50 za milion. Kredyt prepay pokrywa całe zużycie bez opłat miesięcznych.

Błędy i odrzucenia są darmowe, więc płacisz tylko za pomyślne odpowiedzi. Ostatni fragment strumienia zawiera liczbę tokenów. Śledź wydatki na pulpicie nawigacyjnym, aby uniknąć wyczerpania kredytu. Doładuj go USDT lub USDC, aby uzyskać natychmiastowy dostęp.