Documentația API Queen

URL de bază și autentificare

Autentificarea utilizează un token Bearer standard transmis în Authorization header., Această abordare asigură compatibilitatea cu SDK-urile existente OpenAI fără a necesita logică personalizată. Al tău API_KEY este generat instantaneu la înregistrare prin Google sau email. Toate solicitările trebuie să indice către URL-ul de bază specific furnizat pentru serviciu.

• URL de bază: https://api.apiqueen.cc/v1
• Header: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Trimiterea solicitărilor către /v1/chat/completions

Trimite date text către endpoint pentru a primi răspunsuri directe de la model. ID-ul modelului este întotdeauna uncensored, care gestionează subiecte diverse fără refuzurile standard. Puteți specifica parametri precum temperature și top_p pentru a controla creativitatea. Sistemul se așteaptă la o listă de mesaje în formatul standard de chat.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Parametri Model: Temperatură, Top-P și Stop

Controlează generarea răspunsurilor folosind parametrii standard LLM. Setează temperature între 0 și 2 pentru o aleatorietate variabilă. Folosește top_p pentru a filtra cuvintele cu probabilitate scăzută. Definiți stop secvențe pentru a opri ieșirea la anumite declanșatoare. Aceste setări permit o ajustare precisă pentru sarcini de scriere creativă sau recuperare de date factuale.

API-ul ignoră parametrile nesuportate în mod elegant. Concentrați-vă pe temperature, top_p, și stop pentru rezultate optime. Ajustați aceste valori în funcție de toleranța la zgomot a aplicației dvs.

Răspunsuri în streaming și consumul de tokeni

Activați streaming-ul setând stream: true în cererea ta. API-ul returnează fragmente de date prin Evenimente trimise de server (SSE). Detaliile de utilizare a tokenilor apar doar în fragmentul final al fluxului. Acest lucru permite randarea în timp real a răspunsurilor în interfața dvs. utilizator.

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)

Gestionați răspunsurile parțiale cu atenție. Asigurați-vă că clientul dvs. bufferizează datele până la închiderea fluxului.

Apelarea funcțiilor și modul JSON

Utilizează apelarea de funcții pentru extragerea datelor structurate. Definește instrumentele în tools parametru. Modelul returnează JSON valid când response_format este setat la {"type": "json_object"}. Acest lucru asigură o analiză consistentă în aplicațiile downstream.

Setează tool_choice pentru a forca apeluri de funcții specifice. Acest lucru este util pentru fluxurile de lucru automatizate care necesită formate de output stricte.

Gestionarea erorilor și limitele de rată

Monitorizează codurile de status HTTP pentru probleme comune. O eroare 401 înseamnă că cheia ta API este invalidă. O eroare 402 indică credit preplătit insuficient. Erorile nu consumă soldul de tokeni. Limitele de rată impun 300 de solicitări pe minut per cheie. Solicitățile concurente sunt limitate la 8. Fereastra de context suportă 100.000 de tokeni în total.

Gestionați retry-urile cu backoff exponențial. Verificați error object în răspunsurile JSON pentru detalii.