Rychlý průvodce model apis

Autentizace a základní URL

Koncový bod se nachází na https://api.modelapis.cc/v1. Předáte svůj klíč v Authorization hlavička jako bearer token. Systém zamítne požadavky s neplatnými klíči chybou 401 a blokuje pokusy o utracení kreditu, který nemáte, odpovědí 402. Nový klíč můžete vygenerovat ihned na dashboardu a starý klíč okamžitě ztratí platnost.

Odesílání dokončení chatu

Odeslat požadavek POST na /v1/chat/completions vaší historií zpráv. ID modelu je „uncensored“ a přijímá standardní parametry jako temperature a top_p. Toto nastavení funguje s jakýmkoli klientem, který používá OpenAI protokol, včetně Cursoru a dalších vývojářských nástrojů.

Copycurl https://api.modelapis.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "get current unix timestamp"}]
  }'

Zkontrolujte odpověď na content pole uvnitř zprávy asistenta. Pokud překročíte limit rychlosti, API vrátí stavový kód 429. Můžete monitorovat svůj zbývající zůstatek přímo v dashboardu dashboard bez nutnosti ručně parsovat hlavičky.

Streamované odpovědi přes SSE

Povolte streamování nastavením stream: true ve vašem těle požadavku. API vrací události odeslané serverem (SSE) obsahující částečné bloky textu. Tento přístup je ideální pro vytváření chat rozhraní, která vykreslují text, jak je generován.

Copyfrom openai import OpenAI

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

Každý chunk obsahuje pouze fragment finální odpovědi. Poslední chunk obsahuje úplné statistiky využití tokenů pro požadavek. To vám umožňuje sledovat náklady v reálném čase bez čekání na dokončení celé generace.

Volání funkcí a nástroje

Definujte své nástroje v tools parameter a nastavte tool_choice na autoModel vrací strukturované volání nástrojů, když je to vhodné, což umožňuje vaší aplikaci provádět externí funkce. Tato funkce bezproblémově funguje se standardními SDK OpenAI.

Copyimport OpenAI from "openai";

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

Parsovejte tool_calls pole v zprávě asistenta pro vyvolání logiky na vašem backendu. Výsledky pak můžete vrátit zpět do konverzace jako odpovědi nástrojů. Tento cyklus umožňuje komplexní agentic pracovní postupy bez opuštění API.

Vynucení režimu JSON

Nastavit response_format na {"type": "json_object"} donutit model k výstupu platného JSON. Toto je klíčové pro aplikace, které parsovaly odpověď programově. Model se bude striktně držet tohoto omezení.

Použijte tento režim, když potřebujete předvídatelné struktury pro vaše datové potrubí. Snižuje potřebu post-processing regex hacků. Model zůstává bez omezení i v režimu JSON, dodává surová data bez filtrů obsahu.

Limity tokenů a kontextové okno

Okno kontextu podporuje až 100 000 tokenů pro prompt i completion dohromady. Na požadavek můžete získat až 16 000 výstupních tokenů. Pokud nespecifikujete max_tokens, výchozí hodnota je 2 048 tokenů.

Požadavky jsou omezeny na 300 za minutu na klíč. Maximální velikost těla požadavku je 8 MB. Tato omezení zajišťují stabilní výkon pro vysokoprovozové využití. Chyby a zamítnutí nespotřebují váš předplacený kredit, takže platíte pouze za úspěšné generování.

Streamování

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)