Rychlý start API
Připojte svou aplikaci k uncensored LLM API během minut pomocí standardních OpenAI-kompatibilních endpointů. Tento návod pokrývá autentizaci, základní požadavky, streamování a technická omezení, která potřebujete znát.
Ověření & základní URL
API používá standardní kompatibilní autentizaci OpenAI. API klíč obdržíte ihned po registraci přes Google nebo e-mail. Tento klíč použijte v Authorization hlavička pro všechny požadavky. Základní URL je pevně nastavena na https://api.mistralabliterated.com/v1. Pro cestu koncového bodu není potřeba další konfigurace.
curl https://api.mistralabliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the first five prime numbers"}]
}'Váš klíč identifikuje váš účet a sleduje využití. Pokud klíč ztratíte, vygenerujte nový; starý se stane neplatným.
POST /v1/chat/completions
Pošlete zprávy do modelu pomocí standardního endpointu dokončování chatu. ID modelu je vždy uncensored. Tento endpoint zpracovává interakce text-in, text-out bez nutnosti složitých struktur payloadů. Do jednoho požadavku můžete odeslat zprávy system, user a assistant.
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralabliterated.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)Požadavek vrací strukturovanou JSON odpověď obsahující výstup modelu. Můžete upravit parametry jako temperature a top_p pro ovládání kreativity. Model neodmítá legální dospělá nebo kontroverzní témata, poskytuje syrový styl odpovědí. Chyby vracejí standardní HTTP status kódy pro snadné ladění ve vašem kódu.
GET /v1/models
Vyhledejte dostupné modely pro ověření připojení a konfigurace. Tento endpoint vrací seznam dostupných modelů, čímž potvrzuje správnost vašeho ověření a základní URL. Je užitečný pro testování integrace před odesláním náročných payloadů.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralabliterated.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);Odpověď zahrnuje ID modelu a typ objektu. Tento koncový bod můžete použít v sekvenčním procesu spuštění vaší aplikace, abyste zajistili, že je API dosažitelné. Vrací se okamžitě s nízkou latencí, což z něj činí ideální pro kontrolu stavu. Tento požadavek nespotřebovává kredit.
Streamování & Nástroje
Povolte streamování nastavením stream: true ve vaší žádosti. API odesílá textové chunky prostřednictvím Server-Sent Events (SSE) ihned po jejich vygenerování. To snižuje vnímanou latenci pro uživatele čekající na dlouhé odpovědi. Pomocí volání funkcí můžete také předat seznam nástrojů v žádosti.
stream = 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)Statistiky spotřeby tokenů jsou zahrnuty v posledním bloku streamu. To vám umožňuje sledovat náklady v reálném čase. Model podporuje režim JSON pro strukturované výstupy, když nastavíte response_format na {"type": "json_object"}. Volby nástrojů jsou flexibilní, umožňují konkrétní nebo automatický výběr.
Parametry & Limity
Okno kontextu podporuje 100 000 tokenů pro kombinaci promptu a completion. Maximální výstup na požadavek je 16 000 tokenů, nebo 2 048, pokud nespecifikujete max_tokens. Můžete ovládat generování pomocí temperature, top_p, stop, a seed parametrů. K dispozici jsou také penalizace za frekvenci a přítomnost pro jemné doladění.
Omezení rychlosti umožňují 300 požadavků za minutu na klíč a 8 souběžných požadavků. Maximální velikost těla požadavku je 8 MB. Tyto limity zajišťují stabilní výkon pro aplikace s vysokou propustností. Přizpůsobte svou strategii dávkování tak, abyste zůstali v těchto mezích.
Chyby & Ceník
HTTP 401 znamená neplatný nebo chybějící klíč API. HTTP 402 znamená, že jste vyčerpali předplacené kredity; doplňte je pomocí kryptoměn, abyste mohli pokračovat. HTTP 429 signalizuje vyčerpání limitu rychlosti; počkejte nebo snižte paralelismus. Chyby nepožívají kredit, takže za neúspěšné požadavky neplatíte.
Cena je 0,15 $ za milion vstupních tokenů a 0,50 $ za milion výstupních tokenů. Kredit nevyprší a nejsou zde žádné měsíční poplatky. Vklady začínají částkou 20 $ s bonusy za větší částky. Vrácení peněz není možné, ale podpora může opravit dvojí účtování.
Časté otázky
Jaká je základní URL adresa API mistral abliterated?
Základní URL je HTTPS://api.mistralabliterated.com/v1. Použijte tuto URL pro všechna SDK kompatibilní s OpenAI nastavením parametru base_url. Pro standardní chatové dokončování nejsou potřeba žádné další varianty endpointů.
Jak řešit odpovědi ve formátu streamování?
Nastavte parametr stream na true ve svém požadavku. API vrací Server-Sent Events (SSE) s částmi tokenů. Detaily o využití tokenů jsou zahrnuty v poslední části streamu pro přesnou fakturaci.
Co se stane, pokud narazím na limit rychlosti?
Dostanete stavový kód HTTP 429. Limit je 300 požadavků za minutu na klíč a 8 souběžných požadavků. Sníšte svou souběžnost nebo implementujte exponenciální zpomalení v logice vaší aplikace.
Získejte svůj API klíč za několik sekund
Zaregistrujte se, získejte klíč, aktualizujte základní URL. Jednoduchá integrace.