API Mistral AI: Przewodnik szybkiego startu

Bazowy URL i autoryzacja

Pierwszym krokiem jest skonfigurowanie klienta tak, aby wskazywał na naszą infrastrukturę. Zastąp standardowy adres URL bazowy OpenAI adresem HTTPS://api.apimistralai.com/v1 i wstrzyknij swój unikalny klucz API do nagłówka autoryzacji. Ta prosta zmiana przekierowuje wszystkie żądania do naszego modelu uncensored, zachowując jednocześnie istniejącą logikę integracji.

• Bazowy URL: HTTPS://api.apimistralai.com/v1
• Uwierzytelnianie: Token Bearer poprzez Authorization nagłówek

Upewnij się, że Twój klucz jest aktywny w panelu konta przed testowaniem połączeń.

Pierwsze żądanie

Wyślij standardowe żądanie chat completion, aby zweryfikować łączność i odpowiedź modelu. Poniższe curl cel polecenia uncensored model z podstawowym promptem.

To potwierdza, że punkt końcowy jest osiągalny i zwraca tekst bez standardowych filtrów treści.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Jeśli odpowiedź zawiera tekst, Twoja integracja jest pomyślnie kierowana przez naszą warstwę wnioskowania uncensored.

Integracja SDK Python

Użyj oficjalnej biblioteki Pythona OpenAI do interakcji z naszym API bez modyfikacji struktury głównego żądania. Zainicjuj klienta nowym base URL i swoim kluczem API, a następnie wywołaj chat.completions.create.

To podejście pozwala zachować całą istniejącą logikę Pythona, zyskując jednocześnie dostęp do możliwości niecenzurowanego modelu.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.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)

Obiekt odpowiedzi zachowuje się identycznie jak standardowe odpowiedzi OpenAI, co ułatwia migrację dla programistów Pythona.

Integracja SDK Node

Dla środowisk JavaScript lub TypeScript zainicjuj pakiet OpenAI niestandardowym adresem URL bazowym. Ustaw apiKey i baseURL właściwości przed wywołaniem chat.completions.create.

To zapewnia, że aplikacje Node.js kierują żądania do naszego endpointu bez cenzury, zachowując jednocześnie kompatybilność ze standardowymi wzorcami SDK.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.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);

Struktura odpowiedzi pozostaje spójna ze standardami OpenAI, umożliwiając łatwą integrację z istniejącymi przepływami pracy Node.js.

Odpowiedzi strumieniowe przez SSE

Włącz generowanie tokenów w czasie rzeczywistym, ustawiając stream: true w Twoim żądaniu. API zwraca strumień zdarzeń wysyłanych serwerowo (SSE), umożliwiając przetwarzanie tokenów w miarę ich generowania.

To zmniejsza postrzeganą latencję dla użytkowników i zapewnia natychmiastową informację zwrotną podczas długich uzupełnień.

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)

Przetwarzaj strumień danych SSE, aby wyświetlać tokeny inkrementalnie. Ostatni fragment zawiera całkowite użycie tokenów dla żądania.

Limity, Błędy i Kontekst

Monitoruj swoje użycie względem ścisłych limitów prędkości i obsługuj powszechne błędy HTTP w sposób elegancki. Masz dozwolone 300 żądań na minutę i 8 żądań równoległych na klucz.

Błąd 401 oznacza nieprawidłowy lub brakujący klucz API, podczas gdy błąd 402 oznacza wyczerpanie salda kredytowego. Status 429 oznacza przekroczenie limitu 300 żądań na minutę.

Twój kontekst obsługuje 100 000 tokenów łącznie, z maksymalną długością odpowiedzi 16 000 tokenów na żądanie. Błędy i odrzucenia nie zużywają kredytu, zapewniając, że płacisz tylko za faktycznie wygenerowaną treść.