Documentația și endpointurile API Codex

URL de bază și autentificare

Trimiteți solicitări către URL-ul de bază https://api.codexapipricing.com/v1 utilizând cheia ta API. Acest endpoint este compatibil cu SDK-urile standard OpenAI, așa că trebuie doar să actualizezi base URL și să furnizezi cheia ta. Autentifică-te trecând header-ul Authorization: Bearer YOUR_API_KEY cu fiecare solicitare. Poți genera o cheie imediată autentificându-te cu Google sau cu email și parolă. Cheia este afișată o singură dată după creare, deci salveaz-o în siguranță. Solicitărilor tale nu li se utilizează datele pentru antrenament, asigurând confidențialitatea datelor tale.

Endpoint Completări Chat

Folosește POST /v1/chat/completions endpoint pentru a genera text. Aceasta este interfața principală pentru trimiterea prompturilor și primirea răspunsurilor. ID-ul modelului este întotdeauna uncensored, indiferent de versiunea modelului care rulează pe serverele noastre. Puteți verifica modelele disponibile prin GET /v1/models. Trimite istoricul mesajelor în messages

Parametrii suportate și modul JSON

Controlează generarea cu parametri precum temperature, top_p, și stop. Folosiți response_format setat la {"type": "json_object"} pentru a forța output-ul JSON. Acest lucru este util pentru extragerea datelor structurate sau pentru apelarea de funcții. De asemenea, puteți seta max_tokens limitarea lungimii ieșirii, cu o valoare implicită de 2.048 dacă este omisă. Fereastra de context suportă până la 100.000 de tokeni pentru prompt și completare combinate. Trimite seed pentru rezultate deterministe sau presence_penalty și frequency_penalty pentru a ajusta repetarea. Acești parametri permit ajustarea fină a comportamentului modelului fără configurare complexă. Modul JSON asigură formatarea strictă pentru analizarea fiabilă în aplicația dvs.

Răspunsuri în flux prin SSE

Activați streaming-ul setând stream: true în cererea dumneavoastră. API-ul returnează Evenimente trimise de server (SSE) pe măsură ce tokenii sunt generați. Acest lucru reduce latența percepută pentru răspunsuri lungi. Detaliile de utilizare a tokenilor apar în fragmentul final al fluxului. Puteți procesa tokenii incremental pentru a afișa textul în timp real. Această funcție funcționează cu toate SDK-urile compatibile OpenAI. Streaming-ul este ideal pentru interfețele de chat unde utilizatorii așteaptă feedback imediat. Ultimul fragment conține numărul total de tokeni pentru acuratețea facturării. Utilizați această metodă pentru a gestiona ieșirile mari fără a aștepta răspunsul complet.

Limitări de rată și corpuri de cereri

Fiecare cheie API este limitată la 300 de cereri pe minut și 8 cereri concurente. Dimensiunea maximă a corpului cererii este de 8 MB. Dacă depășiți aceste limite, primiți un error 429. Puteți genera chei noi pentru a înlocui pe cele existente, dar este activă doar o singură cheie per cont. Erorile și refuzurile nu se numără în limita de rată. Fereastra de context de 100.000 de tokeni permite un istoric extins de conversații. Mențineți corpurile cererilor concise pentru a rămâne în limitele de dimensiune. Monitorizați-vă utilizarea pentru a evita întreruperile în orele de vârf. Aceste limite asigură o utilizare echitabilă pentru toți clienții preplătiti.

Gestionarea erorilor și depanarea

Gestionați erorile verificând codul de stare HTTP. O eroare 401 indică o cheie API invalidă sau lipsă. O eroare 402 înseamnă că creditul preplătit s-a epuizat. O eroare 429 semnalează că ați depășit limitele de rată. Utilizați error câmp în răspuns pentru a obține detalii. Greșelile precum dubla facturare sunt remediate prin pagina de Suport. Creditul nu expiră niciodată, așa că poți reîncărca mai târziu. Refuzurile pentru încălcările politicilor de conținut sunt gratuite. Această structură de eroare predictibilă te ajută să depanezi rapid problemele de integrare fără a ghici cauza.

cURL

Copycurl https://api.codexapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the hourly rates for the large model."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Streaming

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)