Integrace krok za krokem pro LLM API uncensored.com

Požadavky: SDK a nastavení prostředí

Nainstalujte preferovanou jazykovou SDK pro komunikaci s endpointem. Většina vývojářů používá oficiální OpenAI SDK pro Python, Node.js nebo Go. To funguje proto, že API následuje standardní schéma chatových dokončení OpenAI.

Ujistěte se, že vaše prostředí má Python 3.8+ nebo Node.js 18+. Nainstalujte balíček přes pip nebo npm. Budete potřebovat API key z dashboardu. Pro registraci není vyžadováno telefonní číslo.

• Python: pip install openai
• Node.js: npm install openai

Uložte svůj API klíč do proměnné prostředí. Tím předejdete náhodnému odhalení ve verzionovacím systému. Klíč poskytuje přístup k modelu bez omezení.

Konfigurace základní URL

Nasměrujte klienta SDK na správnou základní URL. Toto je nejdůležitější krok pro úspěšnou integraci. Výchozí základní URL OpenAI pro tuto službu nebude fungovat.

Nastavte základní URL na HTTPS://api.uncensoredaicom.com/v1. To směruje požadavky do infrastruktury uncensored LLM. ID modelu, které musíte poslat, je "uncensored". Jedná se o open-weight model vyladěný pro minimální odmítání.

Ověřte připojení voláním endpointu models. To potvrzuje, že vaše přihlašovací údaje a základní URL jsou správné. Úspěšná odpověď vrací ID modelu a typ objektu.

Nastavení ověření a hlaviček

Předávejte svůj klíč API v hlavičce Authorization. Pro všechny požadavky použijte schéma Bearer. Tato hlavička autentizuje váš účet s předplacenými prostředky.

Nastavte hlavičku jako: Authorization: Bearer YOUR_API_KEY. SDK toto zajišťuje automaticky, pokud předáte klíč do konstruktoru klienta. Ujistěte se, že nejsou zahrnuty žádné další mezery. Neplatné klíče vracejí chybu 401 Unauthorized.

Získáte jeden aktivní klíč na účet. Vygenerování nového klíče zneplatní předchozí. To zjednodušuje rotaci klíčů a správu zabezpečení. Uchovávejte svůj klíč v bezpečí ve svém nasazeném prostředí.

Odesílání standardního požadavku na chat

Odešlete POST požadavek na /v1/chat/completions. Odešlete své zprávy jako pole objektů s rolí a obsahem. Systém podporuje role uživatele, asistenta a systému.

Příklad struktury: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API vrací dokončení textu. Celkový kontextový okno má 100,000 tokenů. Max výstup je 16,000 tokenů na požadavek.

Chyby a odmítnutí nespotřebují kredit. To chrání váš předplacený zůstatek. Nastavte teplotu a top_p pro kontrolu. Výchozí hodnoty fungují pro většinu případů použití.

Povolování streamování pro výstup v reálném čase

Nastavit stream: true ve vašem těle požadavku. Tím aktivujete události odeslané serverem (SSE). Tokeny přicházejí inkrementálně místo čekání na úplné dokončení.

Parsovejte SSE stream pro zobrazení textu v reálném čase. Konečná část obsahuje statistiky využití tokenů. To umožňuje přesné sledování fakturace. Streamování snižuje vnímanou latenci pro koncové uživatele.

Zvládněte síťové přerušení elegantně. Připojte se znovu, pokud se stream připojení přeruší. API uncensored podporuje stabilní streamování. Sledujte stav připojení. Použijte to pro chat rozhraní nebo generování dlouhého formátu.

Použití nástrojů a volání funkcí

Definujte nástroje v těle žádosti. Předáte seznam schémat funkcí. Model může tyto funkce volat na základě záměru uživatele. To umožňuje chování podobné agentovi.

Upřesnit tool_choice ovlivnit výběr funkce. Použijte auto pro automatickou detekci. API podporuje standardní definice nástrojů. Analyzujte argumenty volání funkce z odpovědi.

Implementujte vykonávání funkce ve vašem kódu. Pošlete výsledek zpět jako zprávu. Model pokračuje v konverzaci. To umožňuje komplexní pracovní postupy. Testování zajišťuje přesné parsování argumentů.

Zvládání odpovědí v režimu JSON

Nastavit response_format: {"type": "json_object"}. Toto donutí model výstupovat platný JSON. Použijte to pro extrakci strukturovaných dat. Zabraňuje chybám při parsování neplatných odpovědí.

Parsovejte JSON řetězec ve svém kódu. Zpracujte možné chyby parsování. Režim JSON zlepšuje spolehlivost pro integrace API. Je ideální pro pipeline zpracování dat.

Kombinujte režim JSON s systémovými prompty. Navedte model k výstupu konkrétních schémat. To zajišťuje konzistentní formátování. Výstup ověřte před jeho použitím. To snižuje chyby v následných procesech.

Sledování limitů a chyb

Respektujte limity rychlosti. Na klíč máte k dispozici 300 požadavků za minutu. Maximálně 8 souběžných požadavků. Velikost těla požadavku je omezena na 8 MB.

Sledujte kódy stavu HTTP. 429 indikuje překročení limitu rychlosti. 400 indikuje špatný požadavek. 500 indikuje chybu serveru. Implementujte exponenciální backoff pro opakování. To zabraňuje přetížení API.

Sledujte využití tokenů v posledním streamovacím bloku. To pomáhá řídit váš předplacený kredit. Chyby nespotřebovávají tokeny. To chrání váš zůstatek. Pravidelné sledování zajišťuje hladký chod.

Výpočet nákladů a využití tokenů

Ceny jsou transparentní a předplacené. Vstupní tokeny stojí 0,15 $ za milion. Výstupní tokeny stojí 0,50 $ za milion. Kredit nevyprší. Neuplatňují se žádné měsíční poplatky.

Doplňte pouze kryptem. USDT (TRC20) nebo USDC (Base). Částky se pohybují od 20 do 500 USD. Bonusový kredit se aplikuje pro větší vklady. +5 % od 50 USD, +10 % od 100 USD, +15 % od 200 USD.

Vypočítejte náklady před intenzivním používáním. Odhadněte počty tokenů pro vaše podněty. To pomáhá efektivně plánovat rozpočet. Chyby jsou zdarma. Refundace nejsou vydávány, ale chyby jsou opraveny. Použijte dashboard pro sledování výdajů.