API MiniMax: Průvodce rychlým startem a SDK

Autentizace a základní URL

Použijte poskytnutý API klíč a nasměrujte svého klienta na vyhrazenou základní URL. Koncový bod pro generování odpovědí je https://api.minimaxaiapi.com/v1/chat/completions. Klíč předáte v Authorization hlavička jako bearer token. Funguje s jakýmkoli standardním SDK OpenAI, protože dodržujeme stejný protokol.

• Název hlavičky: Authorization
• Hodnota hlavičky: Bearer YOUR_API_KEY
• Základní URL: https://api.minimaxaiapi.com/v1

Není vyžadováno složité nastavení. Stačí aktualizovat konfiguraci ve svém existujícím projektu.

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

Endpoint Chat Completions

Odešlete požadavek POST na koncový bod chat completions pro získání textové odpovědi. Identifikátor modelu je uncensored. Musíte zahrnout pole messages s historií konverzace. Systém zpracuje vstup a vrátí vygenerovaný text na základě vašeho podnětu.

Tento endpoint zpracovává veškeré generování textu. Nepodporuje vektory, audio ani video. Můžete streamovat odpovědi nebo čekat na celý blok. Model zpracovává kontext až do celkové délky 100 000 tokenů.

Copyfrom openai import OpenAI

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

Streamování a využití tokenů

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací Server-Sent Events (SSE) pro každý generovaný token. To umožňuje reálné zobrazení výstupu. Statistiky využití tokenů jsou zahrnuty v posledním bloku streamu. To vám pomáhá přesně sledovat náklady bez nutnosti parsování každého jednotlivého tokenu.

Streaming snižuje vnímanou latenci pro dlouhé odpovědi. Je ideální pro chatová rozhraní a dynamickou generaci obsahu. Můžete stream předčasně ukončit, pokud uživatel přeruší generování.

Copyimport OpenAI from "openai";

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

Volání funkcí a režim JSON

Použijte tools parametr pro povolení volání funkcí. Definujte své funkce v těle požadavku a nechte model, aby si vybral, kterou zavolat. The tool_choice parameter vám umožňuje vynutit konkrétní funkci nebo automatický výběr. Pro přísný výstup JSON nastavte response_format na {"type": "json_object"}. To zajišťuje, že odpověď je platný JSON.

Volání funkcí je užitečné pro extrakci strukturovaných dat nebo spouštění akcí. Režim JSON je dokonalý pro integrace API vyžadující předvídatelné formáty. Kombinujte obě funkce pro robustní logiku aplikace.

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)

Parametry a omezení modelu

Upravte chování generování pomocí standardních parametrů jako temperature, top_p, a stop. Maximální kontextové okno má 100,000 tokenů včetně promptu a completionu. Maximální výstup na požadavek je 16,000 tokenů. Pokud nenastavíte max_tokens, limit se výchozím způsobem rovná 2 048 tokenům.

Použít seed pro reprodukovatelné výsledky. Nastavte presence_penalty a frequency_penalty pro ovládání opakování. Tyto parametry vám dávají jemnou kontrolu nad kreativitou a konzistencí modelu. Vždy testujte s vaším konkrétním případem použití a najděte správnou rovnováhu.

Limity rychlosti a chyby

Pokud tyto limity překročíte, obdržíte chybu 429. Chyba 401 indikuje neplatný nebo chybějící API klíč. Chyba 402 znamená, že je váš předplacený kredit vyčerpán.

Chyby nesnižují váš kredit. Můžete zkusit znovu selhané požadavky bez penále. Velikost těla požadavku je omezena na 8 MB. S concurrency pečlivě, abyste předešli omezení. Sledujte své využití prostřednictvím posledního fragmentu streamovaných odpovědí.