API Quickstart: Chat Completions

Autentificare & URL de Bază

Cheia API autentifică fiecare solicitare. Folosește Authorization header cu Bearer scheme. URL-ul tău de bază este https://api.nsfwopenrouter.com/v1. Această URL funcționează cu orice SDK compatibil OpenAI. Nu ai nevoie de abonament. Plătești doar pentru tokenii utilizați. Erorile și refuzurile nu generează costuri. Înregistrează-te prin Google sau email pentru a primi cheia instant.

Trimiterea unei cereri de completare de chat

Trimite o cerere POST la /v1/chat/completions. ID-ul modelului este întotdeauna uncensored. Furnizează promptul tău de sistem pentru a defini comportamentul. Include mesajele de utilizator în messages array. API-ul returnează textul direct. Nu are loc un routing complex. Traficul merge direct la serverele noastre. Acest lucru asigură un management consistent al conținutului NSFW fără filtre amonte.

Gestionarea răspunsurilor de streaming

Activați streaming-ul setând stream pentru true. API returnează Evenimente trimise de server (SSE). Fiecare fragment conține text parțial. Detaliile privind utilizarea tokenilor apar în fragmentul final. Acest lucru reduce latența percepută pentru utilizatori. Permite afișarea în timp real a conținutului generat. Gestionați erorile în logica fluxului. Ignorați fragmentele incomplete în caz de eșec.

Configurarea parametrilor modelului

Ajustați temperature pentru creativitate. Folosește top_p pentru eșantionarea nucleu. Setați max_tokens limitarea lungimii ieșirii. Maximul implicit este de 2.048 de tokeni. Poți solicita până la 16.000 de tokeni per solicitare. Fereastra de context suportă 100.000 de tokeni în total. Acest lucru include atât promptul, cât și completarea. Ajustează fin aceste setări pentru nevoile tale specifice de roleplay.

Activarea modului JSON

Utilizare response_format cu {"type": "json_object"}. Modelul garantează un output JSON valid. Această structură este esențială pentru integrarea programatică. Analizează răspunsul direct în obiectele aplicației tale. Evită analizarea cu regex pentru fiabilitate. Această caracteristică asigură extragerea constantă a datelor. Funcționează perfect cu SDK-urile standard.

Înțelegerea apelurilor de instrumente

Definește instrumente în corpul cererii. Modelul poate returna apeluri de funcții structurate. Utilizează tool_choice pentru a forța comportamente specifice. Acest lucru permite fluxuri de lucru dinamice ale agenților. API-ul suportă formatele standard de tool-uri OpenAI. Parsați tool_calls array în răspuns. Execută funcțiile și returnează rezultatele. Acest lucru permite interacțiuni complexe în mai mulți pași.

cURL

Copycurl https://api.nsfwopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run my unit tests and show results"}]
  }'

Python

Copyfrom openai import OpenAI

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