Snabbstart: Chat Completions API

Förutsättningar och bas-URL

Vårt API är fullt kompatibelt med standardgränssnittet för OpenAI-chattkomplettering. Du behöver bara en bas-URL och en API-nyckel för att börja skicka begäranden. Bas-URL:en är HTTPS://api.howmuchisanapikey.com/v1. Denna enda slutpunkt hanterar all textgenerering utan att du behöver hantera flera tjänst-URL:er eller proxykonfigurationer.

Autentiseringen är enkel. Du måste inkludera en Authorization-header med Bearer-schemat följt av din unika nyckel. Varje begäran till chat-completions-slutpunkten kräver denna header för att validera ditt konto och spåra tokenanvändning mot ditt förbetala kreditbelopp.

Autentisering och headers

Inkludera Authorization-huvudet i varje förfrågan för att verifiera din identitet. Huvudformatet är Authorization: Bearer YOUR_API_KEY. Om nyckeln är ogiltig eller har löpt ut returnerar API:t ett 401-fel omedelbart. Detta säkerställer att endast auktoriserade konton kan förbruka din förbetalda kredit.

Du behöver inte skicka ytterligare huvuden för grundläggande textgenerering. Men om du använder specifika funktioner som JSON-läge eller funktionsanrop måste du ange Content-Type-huvudet till application/json. Detta säger till servern hur den ska analysera din begärans kropp korrekt.

Skickar din första chattslutförande

Skicka en POST-begäran till /v1/chat/completions med din meddelandehistorik och modellidentifierare. Modell-ID:t är "uncensored". Denna modell är finjusterad för att svara utan avslag för lagligt vuxeninnehåll, fiktion eller kontroversiella ämnen. Den filtrerar inte baserat på standardiserade politiska eller sociala normer.

Här är ett grundläggande curl-exempel för att komma igång:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Svaret kommer att innehålla den genererade texten i choices-arrayen. Du kan parsninga detta direkt till din applikationslogik. Varje förfrågan förbrukar inmatningstokens för din prompt och utmatningstokens för modellens svar.

Strömsvaren och tokenanvändning

Använd Server-Sent Events (SSE) för att ta emot tokens när de genereras. Detta minskar den upplevda latensen för långa utdata. Ställ in stream-parametern till true i din begärans kropp. Servern skickar flera chunkar, var och en innehållande en partiell delta av svaret.

Den sista chunken innehåller användningsdata. Detta objekt innehåller totala in- och utdatatokens som förbrukades av begäran. Du kan använda denna data för att uppdatera din lokala kreditbalans eller övervaka dina utgifter i realtid. Streaming är idealiskt för chattgränssnitt där användare förväntar sig omedelbar feedback.

Function calling och JSON-läge

API:et stöder strukturerad utmatning via JSON-läge och funktionssammanfall. Ställ in response_format till {"type": "json_object"} för att tvinga modellen att returnera giltig JSON. Detta är användbart för att extrahera data eller generera strukturerade konfigurationer utan parserfel.

För funktionsanrop, ange ett verktygsarray i din förfrågan. Modellen kommer att svara med tool_calls om den bedömer att en funktion behövs. Du kan sedan exekvera funktionen och skicka tillbaka resultatet till modellen. Detta möjliggar komplexa flerstegsarbetsflöden utan extern parserlogik.

Hantering av begränsningar och fel

Du är begränsad till 300 förfrågningar per minut per nyckel och 8 samtidiga förfrågningar. Om du överskrider dessa gränser får du ett 429 Too Many Requests-fel. Svarsbodyn innehåller retry-after-uppgifter. Justera din klient-sides throttling för att undvika onödiga försök igen.

När din förbetalda kredit är slut returnerar API:t ett 402 Payment Required-fel. Du kan fylla på via krypto när som helst. Fel och avslag är gratis, så du betalar bara för lyckad token-generering. Kontextrutan är 100,000 tokens för prompt och completion tillsammans.

Python

Copyfrom openai import OpenAI

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

Strömning

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)