API-snabbstart: Anslut din klient till vår obegränsade modell
Denna snabbstart visar hur du pekar en OpenAI-kompatibel klient mot vår obegränsade textmodell. Du behöver en bas-URL, ett modell-ID och din nyckel.
Autentisering och bas-URL
Varje begäran skickas till https://doesgrokhaveanapi.com/v1 och förvarar din nyckel i Authorization headern som en bearer-token. Kopiera nyckeln från sidan "Hämta API-nyckel"; den visas när du registrerar dig och du kan byta ut den när som helst.
Kort och rakt: bas-URL:n och nyckeln är de enda två värdena som ändras när du flyttar en befintlig klient.
curl https://api.doesgrokhaveanapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
}'
Chatkompletteringsendpointen
Skicka POST /v1/chat/completions med en lista på meddelanden. Svaret har samma struktur som OpenAI:s chat-completions-svar, så befintliga parsare fortsätter att fungera.
- Använd rollen
userför din prompt ochsystemför instruktioner. - Läs svaret från
choices[0].message.content. - Antal tokens returneras i
usage, och det är vad ditt kreditbelopp debiteras för.
from openai import OpenAI
client = OpenAI(base_url="https://api.doesgrokhaveanapi.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)
Supportad modell: 'uncensored'
Ställ in fältet model till uncensored. Detta är det enda modell-ID:t på tjänsten, så det finns inget att välja mellan. GET /v1/models returneras, vilket är ett snabbt sätt att bekräfta att nyckeln fungerar.
Modellen är en modell med öppen vikt som körs på våra egna servrar. Den vägrar inte lagliga vuxen-, fiktiva eller kontroversiella anrop. Den enda hårda gränsen är sexuellt innehåll som involverar minderåriga.
Strömning och funktionsanrop
Lägg till stream: true för att ta emot tokens som server-sända händelser. Den sista chunken innehåller användningssiffrorna, så du kan logga kostnad per begäran utan ett andra anrop.
Funktionsanrop fungerar via standarden tools och tool_choice fält. Definiera varje funktion med ett JSON-schema och läs tool_calls svarets array.
stream = 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)
Parametrar: Temperatur, Top P och Stop
De stödda parametrarna för stickprov är temperature, top_p, stop, seed, presence_penalty och frequency_penalty. Använd en låg temperatur för kod och extraktion, och en högre för skönlitteratur.
Om du inte anger max_tokens, standardgränsen för utdata är 2 048 tokens. Den absoluta maxgränsen per begäran är 16 000 tokens.
JSON-läge och svarsformat
Ställ in response_format för { 'type': 'json_object' } när du behöver maskinläsbar utskrift. Be om JSON i prompten också, eftersom modellen följer instruktionen och formatet tillsammans.
- Beskriv de fält du behöver i systemmeddelandet.
- Håll exemplet kort, två eller tre nycklar.
- Validera resultatet i din kod innan du lagrar det.
Rate Limits och felhantering
Varje nyckel kan skicka 300 begäranden per minut och 8 begäranden samtidigt. Begäranden med en kropp över 8 MB avvisas. En 401 betyder att nyckeln är felaktig, en 402 betyder att krediten har tagit slut, och en 429 betyder att du har nått hastighetsgränsen: vänta och försök igen med backoff.
Fel och avvisningar debiteras inte. Håll kontextfönstret på 100 000 tokens i åtanke för långa trådar: prompt och komplettering räknas tillsammans.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.doesgrokhaveanapi.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);Vanliga frågor
Vilken bas-URL ska jag använda?
Använd https://doesgrokhaveanapi.com/v1 som bas-URL. Alla OpenAI-kompatibla SDK:er accepterar den när du ändrar bas-URL och nyckel, och inget annat i din kod behöver ändras.
Vilket modell-ID ska jag skicka?
Skicka okorrigerat. Det är den enda modellen på tjänsten. Anropa GET /v1/models för att bekräfta id:t och att din nyckel är aktiv innan du kör större jobb.
Varför returnerar min begäran 402?
Ett 402-svar betyder att det förbetala kreditbeloppet på kontot är slut. Ladda upp med USDT på TRC20 eller USDC på Base från $20, och nästa begäran går igenom. Misslyckade begäranden debiteras inte.
Din API-nyckel är ett steg bort
Registrera, kopiera din token, uppdatera slutpunkten. Det är hela processen.