Integrációs útmutató fejlesztőknek

Hitelesítés és Base URL beállítás

Kezdje az API kulcs generálását a műszerfalon. Az alap URL a HTTPS://api.apiaicheap.com/v1. Adja át a kulcsot Authorization fejlécként bearer tokenként.

• Kattintson az "API kulcs megszerzése" gombra, és jelentkezzen be Google-lal vagy e-maillel.
• Másolja ki a kulcsot azonnal; csak egyszer jelenik meg.

Ez a kulcs hitelesíti az összes kérést a chat completions végponthoz.

Példa fejléc

Hitelesítés: Bearer YOUR_API_KEY

Első kérés cURL-lal

Küldjön egy alapvető chat completion kérést a beállítás teszteléséhez. Használja a POST /v1/chat/completions végpontot a "uncensored" modellel.

Ez igazolja a hitel egyenlegedet és a késleltetést.

• Állítsa be a szerepkört "user" értékre.
• Tartsa egyszerűre az üzenetet az első teszt során.

Nézd meg a választ egy generált szöveg mezőre.

• Keresse a "content" értéket.

Ha 200 OK választ kap, az integrációja működik.

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

Python SDK integráció

Használja a hivatalos OpenAI Python könyvtárat a könnyű integrációhoz. Irányítsa a base URL-re és állítsa be az API-kulcsát.

Ez a megközelítés automatikusan kezeli az újrapróbálkozásokat és a JSON elemzést.

• Telepítse a könyvtárat pip segítségével.
• Állítsa be a base_url paramétert az endpointunkra.

Hívja meg a chat.completions.create metódust.

Adja át üzenetlistáját argumentumként.

• Tartalmazza az "uncensored" modell nevét.

Hozzáférés a válasz szövegéhez az objektum attribútumain keresztül.

Ez a módszer tiszta és olvasható termelési szkriptekhez.

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)

Node.js SDK beállítása

A Node.js SDK hasonlóan működik, mint a Python verzió. Inicializálja a klienst a kulcsával és a bázis URL-lel.

Ezzel ismerős async/await mintázatokat használhat.

• Importálja az OpenAI csomagot.
• Konfigurálja az alap URL-t a konstruktorban.

Hozzon létre egy completion kérést az üzeneteivel.

Kezelje a promise-t az eredmény megszerzéséhez.

• Kivonat az üzenet tartalmát a válaszból.

Naplózza a kimenetet, hogy ellenőrizze, a modell helyesen reagál-e.

Ez a beállítás ideális webkiszolgálókhoz és backend szolgáltatásokhoz.

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

Streamelt válaszok SSE-vel

A streamelés engedélyezéséhez állítsa a stream paramétert true értékre a kérésben. Az API a generálás során chunkokat ad vissza Server-Sent Events (SSE) formátumban.

Ez csökkenti a felfogott késleltetést a felhasználók számára chat alkalmazásokban.

• Állítsa be a stream: true értéket a payloadban.
• Feldolgozza minden darabot érkezésekor.

Kombinálja a darabokat a végső válasz létrehozásához.

A tokenhasználati részletek az utolsó darabban jelennek meg.

• Ellenőrizze a "usage" mezőt az utolsó darabban.

Ez a megközelítés élénknek tartja a felhasználói felületet hosszú generálások sorá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)

Korlátok, hibák és kontextus ablak

A fiókod percenként 300 kérésre van korlátozva kulcsonként. A kontextusablak 100 000 tokenes teljes kapacitást támogat prompt és completion együttesen.

A hibákat szabványos HTTP státuskódokkal kezeljük.

• A 401 egy érvénytelen vagy hiányzó API-kulcsra utal.
• A 402 azt jelenti, hogy az előre fizetett hitel kimerült.
• A 429 azt jelzi, hogy túllépte a sebességkorlátot.

A visszautalások nem costolnak kreditet. A hibák szintén ingyenesek.

Max. kimenet 16,000 token kérésenként. Állítsa be a max_tokens értéket, ha kevesebbre van szüksége.

Ez a felépítés kiszámítható számlázást és teljesítményt biztosít.