Rychlý start: Připojení klienta

Požadavky a instalace SDK

Nainstalujte oficiální SDK pro váš jazyk, které automaticky zpracuje autentizaci a serializaci požadavků. Potřebujete platný API klíč a základní URL nakonfigurované ve vašem klientském prostředí. Naše služba přijímá standardní parametry jako temperature a top_p bez nutnosti vlastních hlaviček.

Ujistěte se, že vaše environmentální proměnná bezpečně obsahuje token před spuštěním jakýchkoli skriptů. Verze SDK musí být aktuální, aby správně podporovaly funkce streamování a JSON mode. Pro generování pouze textu nejsou vyžadovány žádné další ovladače.

Konfigurace základní URL a klíče

Nasměrujte klienta na naši konkrétní základní URL pro směrování požadavků naší infrastrukturou bez omezení. Použijte hlavičku Authorization: Bearer YOUR_KEY pro autentizaci každého hovoru. Toto nastavení funguje stejně pro lokální testování i nasazení produkčních skriptů.

Nahraďte výchozí endpoint OpenAI naším hostem, abyste předešli záměně s jinými poskytovateli. Udržujte svůj klíč v tajnosti a nezveřejňujte ho ve veřejných repozitářích. Konfigurace zůstává statická, dokud neotočíte klíčem.

Odeslání první žádosti

Pro ověření připojení a formátu odpovědi proveďte standardní volání chat completions. Pošlete jednoduchý prompt, abyste potvrdili, že model vrací text bez odmítnutí. Tento test zajišťuje, že váš klíč má dostatečný předplacený kredit pro využití.

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"}]
  }'

Zkontrolujte odpověď na podrobnosti o obsahu a využití tokenů. Pokud obdržíte chybu 401, ověřte formát klíče. 402 znamená, že potřebujete doplnit zůstatek kreditu.

Zvládání streamovaných odpovědí

Povolte streamování pro příjem tokenů v reálném čase, jak jsou generovány. To snižuje vnímanou latenci pro uživatele čekající na dlouhé výstupy. Poslední fragment obsahuje konečné počty tokenů pro přesnost fakturace.

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)

Zpracovávejte částečné odpovědi elegantně ve svém kódu klienta. Bufferujte obsah, dokud stream neskončí nebo nevznikne chyba. Streamování funguje se všemi standardními parametry, včetně úprav teploty.

Integrace Python SDK

Použijte Python knihovnu pro správu požadavků s minimálním boilerplate kódem. Inicializujte klienta svou base URL a klíčem pro okamžité použití. Tento přístup zjednodušuje zpracování chyb a parsování odpovědí.

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)

Přistupujte k vygenerovanému obsahu přímo z objektu odpovědi. Zkontrolujte chyby a řádně ošetřete limity rychlosti. SDK podporuje jak synchronní, tak asynchronní pracovní postupy.

SDK pro Node a limity

Integrujte do aplikací Node.js pomocí oficiálního JavaScriptového SDK. Nastavte základní URL tak, aby požadavky směřovaly na náš endpoint bez omezení. Sledujte své využití, abyste zůstali v mezích limitů.

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);

Můžete odeslat 300 požadavků za minutu s souběžností 8. Každé tělo požadavku musí zůstat pod 8 MB. Kontextové okno podporuje celkem 100,000 tokenů. Chyby a odmítnutí nespotřebovávají kredit, ale úspěšné výstupy ano. Chraňte svůj klíč a v případě potřeby ho měňte.

Chápání využití tokenů

Fakturace je založena na skutečně použitých tocnech v promptu a completion. Vstupní tokeny stojí 0,15 $ za milion, zatímco výstupní tokeny stojí 0,50 $ za milion. Předplacený kredit pokrývá všechno využití bez měsíčních poplatků.

Chyby a odmítnutí jsou zdarma, takže platíte pouze za úspěšné odpovědi. Poslední část streamu obsahuje počet tokenů. Sledujte svůj panel pro sledování výdajů a vyhněte se vyčerpání kreditu. Dobijte jej pomocí USDT nebo USDC pro okamžitý přístup.