Průvodce integrací pro vývojáře

Nastavení ověření a základní URL

Začněte vygenerováním svého API klíče na ovládacím panelu. Základní URL je HTTPS://api.apiaicheap.com/v1. Pošlete svůj klíč v hlavičce Authorization jako bearer token.

• Klikněte na „Získat API klíč“ a přihlaste se pomocí Google nebo e-mailu.
• Zkopírujte klíč ihned; zobrazí se pouze jednou.

Tento klíč autentizuje všechny požadavky na endpoint dokončení chatu.

Příklad hlavičky

Autorizace: Bearer Váš_API_KLÍČ

První požadavek pomocí cURL

Odešlete základní dokončení chatu pro otestování nastavení. Použijte koncový bod POST /v1/chat/completions s modelem "uncensored".

Toto potvrzuje zůstatek kreditů a latenci.

• Nastavte roli na "user".
• "Pro první test udržte zprávu jednoduchou."

Zkontrolujte odpověď na pole generovaného textu.

• Hledejte hodnotu „content".

Pokud získáte 200 OK, vaše integrace funguje.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python pro snadnou integraci. Směrujte ji na naši základní URL a nastavte svůj API klíč.

Tento přístup automaticky zpracovává opakování požadavků (retries) a parsování JSON.

• Nainstalujte knihovnu pomocí pip.
• Nastavte parametr base_url na náš endpoint.

Volajte metodu chat.completions.create.

Předávejte svůj seznam zpráv jako argument.

• Zahrňte název modelu "uncensored".

Přistupujte k textu odpovědi prostřednictvím atributů objektu.

Tato metoda je čistá a čitelná pro produkční skripty.

Copyfrom openai import OpenAI

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

Nastavení SDK Node.js

SDK pro Node.js funguje podobně jako verze pro Python. Inicializujte klienta svým klíčem a naší základní URL.

To vám umožní používat známé vzory async/await.

• Importujte balíček OpenAI.
• Nastavte základní URL v konstruktoru.

Vytvořte požadavek na dokončení s vašimi zprávami.

Zpracujte promise pro získání výsledku.

• Extrahujte obsah zprávy z odpovědi.

Logujte výstup k ověření, zda model odpovídá správně.

Toto nastavení je ideální pro webové servery a backendové služby.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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 pomocí SSE

Povolte streamování nastavením stream na true ve vašem požadavku. API vrací chunky, jak jsou generovány prostřednictvím Server-Sent Events.

Toto snižuje vnímanou latenci pro uživatele v chatových aplikacích.

• Nastavte stream: true v payloadu.
• Zpracovávejte každou částu, jak přichází.

Spojte chunky do konečné odpovědi.

Podrobnosti o použití tokenů se objeví v posledním chunku.

• Zkontrolujte pole "usage" v posledním bloku.

Tento přístup udržuje uživatelské rozhraní responzivní během dlouhých generací.

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)

Limity, chyby a kontextové okno

Váš účet má limit 300 požadavků za minutu na klíč. Kontextové okno podporuje celkem 100 000 tokenů pro prompt a odpověď.

Chyby jsou řešeny pomocí standardních stavových kódů HTTP.

• 401 signalizuje neplatný nebo chybějící API klíč.
• 402 znamená, že je vyčerpán váš předplacený kredit.
• 429 signalizuje, že jste překročili limit rychlosti.

Odmítnutí nestojí kredit. Chyby jsou také zdarma.

Max výstup je 16,000 tokenů na požadavek. Nastavte max_tokens, pokud potřebujete méně.

Tato struktura zajišťuje předvídatelné fakturování a výkon.