Ghid de integrare pentru dezvoltatori

Autentificare și configurare URL de bază

Începeți prin a genera cheia API pe panoul de control. URL-ul de bază este HTTPS://api.apiaicheap.com/v1. Trimiteți cheia în antetul Authorization ca token bearer.

• Click "Obține cheie API" și autentifică-te cu Google sau email.
• Copiază cheia imediat; este afișată doar o dată.

Această cheie autentifică toate solicitările către endpoint-ul de completări chat.

Antet exemplu

Autorizare: Bearer CHEIA_DUMNEAVOASTRĂ_API

Prima cerere cu cURL

Trimiteți o completare chat de bază pentru a vă testa configurația. Utilizați endpoint-ul POST /v1/chat/completions cu modelul "uncensored".

Aceasta confirmă soldul de credite și latența.

• Setează rolul la "user".
• Păstrează mesajul simplu pentru primul test.

Verificați răspunsul pentru un câmp de text generat.

• Caută valoarea "content".

Dacă primiți un mesaj 200 OK, integrarea dvs. funcționează.

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

Integrare SDK Python

Utilizați biblioteca oficială Python OpenAI pentru o integrare ușoară. Indicați-l către URL-ul de bază și setați cheia API.

Această abordare gestionează automat reîncercările și analizarea JSON.

• Instalează biblioteca prin pip.
• Stabilește parametrul base_url la capătul nostru.

Apelați metoda chat.completions.create.

Transmiteți lista de mesaje ca argument.

• Includeți numele modelului „uncensored”.

Accesează textul de răspuns prin atributele obiectului.

Această metodă este curată și lizibilă pentru scripturile de producție.

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)

Configurare SDK Node.js

SDK-ul Node.js funcționează similar cu versiunea Python. Inițializează clientul cu cheia ta și URL-ul nostru de bază.

Acest lucru vă permite să utilizați modelele familiare async/await.

• Importați pachetul OpenAI.
• Configurează URL-ul de bază în constructor.

Creați o solicitare de completări cu mesajele dvs.

Gestionează promisiunea pentru a obține rezultatul.

• Extrage conținutul mesajului din răspuns.

Loghează output-ul pentru a verifica dacă modelul răspunde corect.

Această configurare este ideală pentru servere web și servicii backend.

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

Răspunsuri în flux cu SSE

Activați streaming-ul setând stream la true în cererea dumneavoastră. API-ul returnează fragmente pe măsură ce sunt generate, prin Evenimente trimise de Server.

Aceasta reduce latența percepută pentru utilizatori în aplicațiile de chat.

• Setează stream: true în payload.
• Procesează fiecare fragment pe măsură ce sosesc.

Combină fragmentele pentru a forma răspunsul final.

Detaliile de consum de tokenuri apar în ultimul fragment.

• Verificați câmpul "usage" din ultimul fragment.

Această abordare menține interfața utilizatorului rapidă în timpul generărilor lungi.

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)

Limitări, erori și fereastră de context

Contul tău are o limită de 300 de solicitări pe minut per cheie. Fereastra de context suportă 100,000 de tokeni în total pentru prompt și completare.

Erorile sunt gestionate prin coduri de stare HTTP standard.

• 401 indică o cheie API nevalidă sau lipsă.
• 402 înseamnă că creditul tău preplătit este epuizat.
• 429 semnalează că ai depășit limita de rată.

Refuzurile nu costă credit. Erorile sunt, de asemenea, gratuite.

Ieșirea maximă este de 16.000 de token-uri per cerere. Setează max_tokens dacă ai nevoie de mai puțin.

Această structură asigură facturarea și performanța predictibile.