Průvodce integrací

Rychlý start: Vaše první žádost

API je kompatibilní s openai a zrcadlí strukturu Chat Completions. Odesíláte text, přijímáte text. Žádné další endpointy pro embeddings nebo audio vám nezakolísají pracovní postup. Začněte tím, že nasměrujete klienta na naši základní URL.

• Základní URL: HTTPS://api.filtrosemia.com/v1
• ID modelu: "uncensored"

Nahraďte základní URL ve konfiguraci svého SDK. Endpoint řeší vše od roleplay po překlad bez obvyklých filtrů.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Ověření a hlavičky

Předávejte svůj klíč API v standardní hlavičce Authorization. Pro jednoduchost používáme jeden aktivní klíč na účet. Pokud potřebujete nový, vygenerujte jej na svém ovládacím panelu.

• Hlavička: Authorization: Bearer YOUR_API_KEY
• Žádné tokény OAuth ani refresh tokeny ke správě.

"Chraňte svůj klíč. Poskytuje přímý přístup k vašemu předplacenému kreditu. Chyby jako" 401 Unauthorized znamená, že klíč chybí nebo je neplatný.

Copyfrom openai import OpenAI

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

Endpoint Chat Completions

Pošlete zprávy do POST /v1/chat/completions. Model podporuje standardní parametry jako temperature, top_p, a stop sekvence. Je to uncensored model vyladěný pro obsah pro dospělé a kreativní obsah.

• Podporuje json_object formát odpovědi.
• Přijímá definice nástrojů pro volání funkcí.

Požadavky jsou zpracovávány sekvenčně v rámci vašich limitů rychlosti. Ujistěte se, že vaše payload nepřekročí 8 MB.

Copyimport OpenAI from "openai";

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

Streamované odpovědi (SSE)

Použijte Server-Sent Events pro doručování tokenů v reálném čase. To snižuje vnímanou latenci pro dlouhé výstupy. Poslední chunk obsahuje kompletní statistiky o použití tokenů.

• Nastavit stream: true v požadavku.
• Parsovejte SSE stream ve vašem klientovi.

Streamování funguje stejně jako chování standardního SDK OpenAI. Zpracováváte jednotlivé části (chunks), jak přicházejí.

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)

Okno kontextu a limity

Model podporuje kontextové okno o velikosti 100 000 tokenů. To umožňuje náročné úlohy s dlouhými historiemi. Maximální výstup je 16 000 tokenů na požadavek.

• Výchozí max výstup: 2 048 tokenů.
• Limit rychlosti: 300 požadavků za minutu.

Překročení limitů spouští 429 Too Many Requests chybu. Upravte svou konkurenci tak, aby zůstala v mezích. Je povoleno 8 souběžných požadavků na klíč.

Zpracování chyb a tokeny

Zpracujte standardní chyby HTTP. 402 Payment Required znamená, že vaše předplacený kredit je vyčerpán. 429 označuje omezení rychlosti. 401 signály problémů s autentizací.

• Chyby jsou zdarma. Platíte pouze za úspěšné využití tokenů.
• Odmítnutí kvůli politice obsahu je také zdarma.

Zkontrolujte tělo odpovědi na podrobné zprávy o chybách. Použijte je k úpravě logiky opakování nebo frekvence dobíjení kreditu.