Základní URL a ověření
Použijte poskytnutou základní URL a platný API klíč pro připojení klienta. Koncový bod je https://api.qwencodeapikey.com/v1. Musíte zahrnout svůj klíč v Authorization hlavička každého požadavku. To zajišťuje, že služba správně identifikuje váš účet předplaceného kreditu.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Klíč můžete vygenerovat přes Google nebo e-mail na stránce registrace. Klíč se objeví okamžitě. Uchovávejte jej v bezpečí, protože řídí vaše výdaje.
Endpoint Chat Completions
Pošlete zprávy na /v1/chat/completions endpoint pro získání textových odpovědí. Toto je standardní rozhraní pro většinu SDK OpenAI. Definujete model jako uncensored a poskytnout seznam zpráv v messages pole. API zpracuje váš vstup a vrátí vygenerované dokončení.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Ujistěte se, že vaše knihovna klienta ukazuje na správnou základní URL. ID modelu uncensored spouští model s otevřenými váhamy laděný pro menší počet odmítnutí. Zvládá konverzační tahy stejně jako jakékoli jiné rozhraní API pro chat.
Koncový bod Modely
Dotaz GET /v1/models na ověření dostupných modelů a jejich podrobností. Tento endpoint vrací seznam modelů dostupných pro váš klíč. Pomáhá vám potvrdit uncensored model je aktivní a připraven k požadavkům. Použijte jej pro ladění konfigurací klienta před odesláním plných payloadů.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Zkontrolujte strukturu odpovědi, abyste zajistili, že vaše SDK správně parsuje seznam modelů. Tento endpoint nespotřebovává kredit, což jej činí bezpečným pro kontrolní účely při inicializaci.
Parametry požadavků a streamování
Podpora standardních parametrů jako temperature, top_p, stop, a seed.Povolte streamování nastavením stream: true. API odesílá tokeny prostřednictvím Server-Sent Events (SSE). Statistiky využití tokenů se objeví v posledním chunku streamu. To umožňuje zobrazování generovaného textu v reálném čase.
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)
Nastavit max_tokens pro ovládání délky výstupu. Výchozí hodnota je 2 048 tokenů. Toto můžete zvýšit až na 16 000 tokenů na požadavek. Upravte parametry tak, aby vyvažovaly kreativitu a přesnost ve vašich odpovědích.
Limity rychlosti a omezení
Každý klíč umožňuje 300 požadavků za minutu a 8 souběžných požadavků. Maximální velikost těla požadavku je 8 MB. Tyto limity zabraňují zneužití a zajišťují stabilní výkon. Pokud překročíte limit rychlosti, obdržíte chybu 429. Upravte logiku klienta tak, aby zpracovávala opakování s exponenciálním zpomalováním.
Okno kontextu podporuje celkem 100 000 tokenů. To zahrnuje prompt i dokončení. Velké kontexty vyžadují pečlivé řízení tokenů, abyste zůstali v mezích.
Režim JSON a volání funkcí
Použít response_format: {"type": "json_object"} pro strukturovaný výstup. To zajišťuje, že model vrátí platný JSON, užitečný pro programovou integraci. Volání funkcí funguje přes tools parametr. Definujte nástroje ve standardním formátu OpenAI. Model bude volat funkce podle potřeby.
Chyby a odmítnutí nespotřebují kredit. To platí i v případě, že model odmítne požadavek kvůli pevnému limitu obsahu. Platíte pouze za skutečné využití tokenů. Kredit nevyprší, takže jej můžete doplnit, kdykoli vám to vyhovuje.
Zpracování chyb a využití
Zvládněte chyty HTTP plynule. Chyba 401 indikuje neplatný nebo vypršený API klíč. Chyba 402 znamená, že je vyčerpán váš předplacený kredit. Chyba 429 signalizuje překročení limitu rychlosti. Zkontrolujte tělo odpovědi pro podrobné zprávy o chybách.
Použití se sleduje podle klíče. Jeden aktivní klíč na účet zjednodušuje fakturaci. Pokud uděláte chybu, například dvojí účtování, použijte stránku Podpora. Kredit se nevrací, ale zůstává platný. Chyby jsou zdarma, takže selhané požadavky nevyčerpávají váš zůstatek.
Souhrn a nejlepší postupy
Začněte s základní URL a platným klíčem. Použijte uncensored ID modelu pro méně odmítnutí. Streamujte odpovědi pro lepší uživatelský zážitek. Sledujte limity rychlosti, abyste předešli přerušením. Použijte režim JSON pro strukturovaná data. Zpracovávejte chyby pro udržení spolehlivosti. Kredit je předplacený a nikdy nevyprší. Dobijte kryptoměnami, když je to potřeba. Toto API se bezproblémově hodí do existujících kódových základů OpenAI. Žádné nové SDK nejsou vyžadovány. Stačí změnit základní URL a klíč.
