Rychlý start API: Připojte svého klienta k našemu modelu bez omezení
Tento rychlý start ukazuje, jak připojit klienta kompatibilního s OpenAI k našemu uncensored textovému modelu. Potřebujete jednu základní URL, jedno ID modelu a svůj klíč.
Autentizace a základní URL
Každý požadavek jde na https://doesgrokhaveanapi.com/v1 a nese váš klíč v Authorization hlavičku jako bearer token. Zkopírujte klíč ze stránky Získat API klíč; zobrazí se vám po registraci a můžete ho kdykoli nahradit.
Stručně a přímočaře: základní URL a klíč jsou jediné dvě hodnoty, které se mění při přesunu existujícího klienta.
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?"}]
}'
Koncový bod Chat Completions
Odeslat POST /v1/chat/completions se seznamem zpráv. Odpověď má stejný tvar jako odpověď na chatové dokončení OpenAI, takže existující parsery fungují dál.
- Použijte roli
userpro váš prompt asystempro pokyny. - Přečtěete si odpověď z
choices[0].message.content. - Počty tokenů se vrací v
usage, a za to se vám strhává kredit.
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)
Podporovaný model: 'uncensored'
Nastavte pole modelu na uncensored. Toto je jediné model id na službě, takže není co vybírat. GET /v1/models vrátí ho, což je rychlý způsob, jak potvrdit, že klíč funguje.
Model je model s otevřenými váhamy, který běží na našich vlastních serverech. Neodmítá zákonné, fiktivní nebo kontroverzní požadavky. Jediným pevným limitem je sexuální obsah zahrnující nezletilé.
Streamování a volání funkcí
Přidat stream: true pro přijímání tokenů jako události odesílané serverem. Poslední část nese čísla využití, takže můžete logovat náklady na požadavek bez druhého volání.
Volání funkcí funguje prostřednictvím standardu tools a tool_choice pole. Definujte každou funkci pomocí schématu JSON a čtěte tool_calls příchozí odpovědi.
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)
Parametry: Teplota, Top P a Stop
Podporované parametry vzorkování jsou temperature, top_p, stop, seed, presence_penalty a frequency_penalty. Pro kód a extrakci použijte nízkou teplotu a pro fikci vyšší.
Pokud nenastavíte max_tokens, výchozí limit výstupu je 2 048 tokenů. Maximální hodnota na požadavek je 16 000 tokenů.
Režim JSON a formáty odpovědí
Nastavit response_format na { 'type': 'json_object' } když potřebujete strojově čitelný výstup. Požádejte také v promptu o JSON, protože model dodrží pokyn i formát společně.
- Popište pole, která potřebujete v systémové zprávě.
- Udržte příklad krátký, dva nebo tři klíče.
- Ověřte výsledek ve svém kódu před jeho uložením.
Omezení rychlosti a zpracování chyb
Každý klíč může odeslat 300 požadavků za minutu a 8 požadavků současně. Požadavky s tělem větším než 8 MB jsou zamítnuty. 401 znamená, že klíč je špatný, 402 znamená, že došla kredit, a 429 znamená, že jste dosáhli limitu rychlosti: počkejte a zkuste to znovu s backoff.
Chyby a odmítnutí se neúčtují. Mějte na paměti kontextové okno 100 000 tokenů pro dlouhé vlákna: prompt a completion počítají společně.
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);Často kladené otázky
Jakou base URL mám použít?
Použijte https://doesgrokhaveanapi.com/v1 jako základní URL. Jakýkoli OpenAI-compatible SDK ji přijme, když změníte základní URL a klíč, a v kódu není třeba měnit nic jiného.
Jaké model id mám posílat?
Posílejte bezzábranově. Je to jediný model na službě. Zavolejte GET /v1/models pro potvrzení id a toho, že je váš klíč aktivní, než spustíte větší úlohy.
Proč můj request vrací 402?
Odpověď 402 znamená, že předplacený kredit na účtu vypršel. Dobijte jej pomocí USDT na TRC20 nebo USDC na Base od částky 20 $ a další požadavek projde. Selhané požadavky se neúčtují.
Vašim API klíčem je krok od vás
Registrovat se, zkopírovat svůj token, aktualizovat koncový bod. To je celý proces.