Jak integrovat OpenAI API do své aplikace

Pro integraci OpenAI API vytvořte API klíč v projektu OpenAI, uložte ho jako tajný údaj na serveru s názvem OPENAI_API_KEY a volejte API z trasy na svém vlastním serveru pomocí oficiálního SDK od OpenAI – nikdy z kódu v prohlížeči. Podle rychlého startu OpenAI z září 2026 je Responses API výchozím bodem pro nové projekty. Před spuštěním nastavte limit výdajů, omezte délku odpovědí, omezte, jak často může každý uživatel funkci volat, a chyby limitu požadavků řešte opakováním.

Tento návod pokrývá nastavení, postup požadavku, prompty pro AI builder a chyby, které prozrazují klíče nebo stojí peníze. Údaje o OpenAI jsou z jeho oficiální dokumentace ke dni září 2026. Pro obecné pojmy (tokeny, kontextová okna, ceny) si nejprve přečtěte jak používat LLM API.

Co s ním můžete postavit

• Chatovacího asistenta uvnitř aplikace (jak vytvořit aplikaci s AI chatbotem)
• Tlačítka „Shrnout“, „Přepsat“ nebo „Navrhni odpověď“
• Vytahování strukturovaných dat z volného textu: převod e-mailu na objednávku, označování podpůrných tiketů
• Vyhledávání a odpovídání na otázky nad vaším vlastním obsahem
• Generování obrázků, řeči a dalších mediálních funkcí podle dostupných modelů

Další nápady jsou v článku jak přidat funkce AI do aplikace.

Nastavení účtu u OpenAI

1. Vytvořte účet a projekt na platformě OpenAI. Osvědčené postupy OpenAI pro produkci doporučují oddělené projekty pro staging a produkci, aby každý mohl mít vlastní klíče a limity.
2. Vytvořte API klíč projektu. OpenAI doporučuje nastavit datum expirace a klíče pravidelně obměňovat.
3. Nastavte upozornění na výdaje a pevný limit výdajů na stránce limitů. Průvodce OpenAI uvádí, že upozornění vás upozorní, když usage překročí částku, a tvrdý limit vynucuje měsíční strop.
4. Přidejte fakturaci. Dokumentace limitů OpenAI popisuje úrovně využití: vaše limity se automaticky zvyšují, jak v čase utrácíte více.

Postup požadavku

Prohlížeč  ->  vaše trasa na serveru  ->  OpenAI API
           <-  (streamovaná) odpověď  <-

1. Uživatel klikne na tlačítko nebo odešle zprávu.
2. Prohlížeč volá vaši trasu, například POST /api/summarise.
3. Váš server ověří, že je uživatel přihlášen a smí funkci použít.
4. Server sestaví požadavek: instrukce, vstup uživatele a případná data z databáze, která úkol potřebuje.
5. Zavolá OpenAI s klíčem z prostředí. SDK OpenAI čte OPENAI_API_KEY automaticky.
6. Odpověď streamuje nebo vrací a zapisuje využití tokenů.

Oficiální SDK od OpenAI se jmenuje openai jak pro JavaScript/TypeScript (npm), tak pro Python (pip).

Výběr modelu

OpenAI nabízí několik modelů v různých cenách a rychlostech a nabídka se často mění. Začněte menším, levnějším modelem, změřte kvalitu na reálných příkladech a přejděte výš, jen pokud to potřebujete. Název modelu držte v konfigurační hodnotě nebo tajném údaji, abyste ho mohli změnit bez přepisování kódu. Aktuální sazby najdete na stránce cen OpenAI.

Možnosti a kompromisy

Prompty pro váš AI builder

První funkce:

Přidej na stránku tiketu tlačítko „Shrnout“. Volá serverovou trasu POST /api/summarise, která ověří přihlášení, načte tiket a zavolá OpenAI Responses API pomocí oficiálního SDK openai a tajného údaje OPENAI_API_KEY. Název modelu načti z tajného údaje OPENAI_MODEL. Instrukce: „Shrň do 3 odrážek a pak navrhni krátkou odpověď. Nevymýšlej čísla objednávek.“ Omez délku výstupu, odpověď streamuj na stránku a klíč nikdy neposílej do prohlížeče.

Pravidla:

Omez každého uživatele na 30 požadavků AI za hodinu, uložených v databázi. U každého požadavku zapisuj vstupní a výstupní tokeny s ID uživatele a názvem funkce. Pokud OpenAI vrátí 429, respektuj hlavičku Retry-After a opakuj s exponenciálním čekáním a jitterem až třikrát; pak zobraz „AI je zaneprázdněna, zkus to znovu za minutu.“ U každé jiné chyby zobraz přátelskou hlášku a ostatní část stránky ponech funkční.

Řešení chyb a limitů

OpenAI měří limity požadavků několika způsoby, včetně požadavků za minutu a tokenů za minutu, a narazíte na ten, který se vyčerpá jako první. Když limit překročíte, API vrátí 429 s hlavičkou Retry-After. Dokumentace OpenAI říká, že tuto hodnotu berete jako minimum a přidáte malé náhodné zpoždění, aby klienti nezkoušeli znovu všichni najednou.

Počítejte také s:

• Časovými limity u dlouhých generování. Streamování pomáhá a pomáhá i rozumný strop výstupu.
• Výpadky poskytovatele. Funkce AI má selhat elegantně, aniž by rozbila stránku.
• Špatným výstupem. Před uložením ověřte strukturovaný výstup a nedovolte, aby výstup modelu spustil citlivou akci bez kontroly ve vašem kódu.

Časté chyby

• Klíč ve frontendu nebo v repozitáři. Kód v prohlížeči je veřejný a uniklý klíč lze zneužít během minut. Viz jak chránit API klíče.
• Žádný limit výdajů. Smyčka nebo zneužívající uživatel mohou rychle nahromadit velký účet.
• Žádné limity na uživatele. Limit poskytovatele chrání vaši peněženku, ne ostatní uživatele.
• Spoléhání na prompt jako na bezpečnost. Uživatelé mohou napsat „ignoruj předchozí instrukce“. Oprávnění patří do kódu na serveru.
• Posílání víc, než je potřeba. Celé dokumenty a dlouhá historie násobí náklady. Posílejte jen to, co úkol potřebuje.
• Napevno zapsaný název modelu. Modely se aktualizují a vyřazují; udělejte z něj nastavení.
• Posílání osobních údajů bez rozmyslu. Přečtěte si podmínky OpenAI pro použití dat a posílejte jen to, co funkce potřebuje.

Kontrolní seznam

• Oddělené projekty OpenAI (nebo klíče) pro testování a produkci
• Klíč uložen jako tajný údaj na serveru, nikdy v kódu v prohlížeči nebo v repozitáři
• Nastavena upozornění na výdaje a pevný limit výdajů
• Všechna volání jdou přes váš server a kontrolují oprávnění uživatele
• Omezena délka výstupu; název modelu je nastavitelný
• Limit požadavků na uživatele ve vaší aplikaci
• Ošetření 429 s Retry-After, čekáním a jitterem
• Přátelský stav chyby; stránka funguje i bez AI
• Využití tokenů zapisováno pro každou funkci
• Otestováno s dlouhými, prázdnými a nepřátelskými vstupy

Použití OpenAI API v Mythexu

Funkce AI v aplikacích, které stavíte v Mythexu, používají váš vlastní klíč OpenAI a účtují se na váš účet u OpenAI, ne z kreditů na stavbu v Mythexu. Přidejte OPENAI_API_KEY jako tajný údaj projektu přes /secrets, nastavení projektu nebo kartu s tajnými údaji, kterou agent ukáže, když klíč potřebuje, a pak funkci popište promptem podobným těm výše. Po změně tajných údajů u publikované aplikace ji znovu publikujte, aby je převzala. Recept Přidání AI funkcí s vlastními API klíči obsahuje startovací prompt a Tajné údaje v chatu vysvětluje kartu s tajnými údaji. Porovnáváte poskytovatele? Podívejte se na jak integrovat Claude API.

Otázky