Как да използвате LLM API: токени, разходи, ключове и първата ви AI функция

LLM API е уеб услуга, която позволява на приложението ви да изпраща текст към голям езиков модел — като GPT моделите на OpenAI, Claude на Anthropic или Gemini на Google — и да получи отговора му обратно в кода. Регистрирате се при доставчика, създавате API ключ, а сървърът на приложението ви изпраща заявки с този ключ; таксуват ви за всяка заявка според броя на токените (части от текст), които влизат и излизат. Това е всичко, което обикновено означава „добавяне на ИИ към приложение“: добре написана заявка към чужд модел, изпратена безопасно от вашия сървър.

Защо това има значение, когато строите с ИИ

В приложение, създадено с ИИ, има два различни ИИ и лесно ги бъркате:

1. ИИ, който строи приложението ви — агентът на инструмента за създаване, който пише кода.
2. ИИ вътре в приложението ви — функция, която ползват потребителите ви, като чат асистент, бутон „Обобщи това“ или автоматично етикетиране.

Втората използва LLM API с вашия ключ и таксува вашия профил при доставчика. Разбирането на токените, контекста и цените е това, което ви позволява да проектирате функция, която работи, не изтича ключа ви и не ви изненадва със сметка.

Ежедневна аналогия: много способен фрийлансър, платен по дума

Представете си LLM API като отличен писател на свободна практика, до когото се свързвате по имейл и плащате по дума — както за думите, които му изпращате, така и за тези, които ви връща (а думите, които пише, струват повече).

• Той няма памет между имейлите. Ако искате да продължи разговор, поставяте предишните съобщения във всеки нов имейл.
• Може да чете само определено количество наведнъж. Това ограничение е контекстният прозорец.
• По-ясното задание води до по-добър и по-кратък отговор — което е и по-евтино.

Основните понятия

Токени

Моделите четат и пишат текст на токени. Документацията за цените на Anthropic оценява около 4 знака, или приблизително 0,75 английски думи, на токен към септември 2026 г. Различните модели и езици се токенизират по различен начин, затова приемете това като груба насока. Всичко се брои: вашите инструкции, съобщението на потребителя, всички включени документи, предишният разговор и отговорът.

Вход и изход

Входните токени са това, което изпращате. Изходните токени са това, което моделът пише. По страниците с цени на OpenAI, Anthropic и Google към септември 2026 г. изходните токени струват няколко пъти повече от входните за един и същ модел. В цените на Gemini на Google е отбелязано също, че вътрешното „разсъждение“ на модела се брои като изход.

Контекстен прозорец

Максималният брой токени, които модел може да приеме в една заявка, включително отговора. Съвременните модели приемат много дълги входове — някои от текущите модели на Anthropic например до един милион токена. Но дългите входове струват повече и отнемат повече време, затова изпращайте само това, което задачата изисква.

Заявки без състояние

При повечето API от чат тип всяка заявка стои самостоятелно по подразбиране. За да „помни“ чатът, приложението ви изпраща отново предишните съобщения с всяко ново. Затова дългият разговор струва повече на съобщение, отколкото кратък.

Системната подкана

Инструкциите, които задават ролята и правилата на модела за всяка заявка: „Обобщаваш заявки към поддръжката в три точки. Никога не включвай имейл адреси на клиенти.“ Потребителите не я виждат, но тя оформя всеки отговор.

Потоково предаване

Вместо да чака пълния отговор, API може да изпраща текста, докато се генерира, така че потребителите виждат думите да се появяват веднага. Така чат интерфейсите изглеждат много по-бързи.

Как работи ценообразуването

Към септември 2026 г., проверено по страниците с цени на самите доставчици:

Някои доставчици предлагат и възможност да пробвате преди да платите: Anthropic дава на новите потребители малко безплатен кредит, а Gemini API на Google има безплатен план при някои модели, с уговорката, че съдържание, изпратено по него, може да се използва за подобряване на продуктите на Google.

Цените се различават много между малките, бързи модели на един доставчик и най-големите му модели, а и се променят често, затова тук не ги посочваме. Прост оценка за всяка функция е: (входни токени × входна цена + изходни токени × изходна цена) × брой заявки на месец. След това добавете резерв и задайте месечен лимит на разходите в таблото на доставчика.

Примерен случай: бутон „Обобщи този сигнал“

Мал екип за поддръжка иска бутон, който превръща дълга нишка от имейли на клиент в три точки и предложен отговор.

1. Вземете ключ. Създайте профил при един доставчик и генерирайте API ключ. Задайте нисък месечен лимит на разходите.
2. Съхранете ключа като тайна на сървъра си, с име като ANTHROPIC_API_KEY или OPENAI_API_KEY — никога в кода на страницата. Вижте променливи на средата и тайни данни.
3. Добавете сървърен маршрут, POST /api/summarise, който:
   • проверява дали човекът е влязъл и принадлежи към екипа по поддръжка;
   • зарежда сигнала от базата данни;
   • изпраща на доставчика системна подкана („Обобщи в три точки, после напиши учтив отговор; не измисляй номера на поръчки“) заедно с текста на сигнала;
   • ограничава дължината на отговора с настройка за максимален брой изходни токени;
   • връща резултата и записва колко токена е използвал.
4. Бутонът извиква вашия маршрут, а не доставчика, и показва обобщението, докато се появява.
5. Обработете грешките. Ако доставчикът е бавен или върне грешка, покажете „Не можахме да обобщим в момента“ и запазете сигнала работещ.
6. Измервайте. След седмица погледнете записите за токените. Ако повечето разходи идват от дълги имейл нишки, съкратете цитираната история преди изпращане.

Обърнете внимание какво липсва: няма обучение на модел, няма специална инфраструктура. Един ключ, един сървърен маршрут, една добре написана подкана.

Ключови термини

• API ключ: тайната, която идентифицира профила ви пред доставчика. Всеки, който я има, може да харчи парите ви.
• Модел: конкретният LLM, който извиквате. Доставчиците предлагат няколко размера на различни цени и скорости.
• Температура: настройка за това колко разнообразни са отговорите. По-ниската стойност е по-предвидима.
• Максимални токени: таван на дължината на отговора, който също ограничава разходите.
• Лимит на заявките: колко заявки или токени може да използва профилът ви в минута.
• Вграждания (embeddings): числа, които представят значението на текста, използвани за търсене в собствените ви документи.
• RAG (генериране с извличане): намиране на подходящи пасажи от собствените ви данни и включването им в подканата, така че моделът да отговаря според вашето съдържание.
• Използване на инструменти / извикване на функции: позволяване на модела да поиска от приложението ви да изпълни конкретна функция, например „провери статуса на поръчката“.

Често срещани грешки и заблуди

• Ключът в кода на фронтенда. Най-скъпата грешка. Кодът в браузъра е публичен. Винаги извиквайте от сървъра си. Списъкът за сигурност за приложения, създадени с ИИ обхваща това заедно с другите проверки преди пускане.
• Без лимит на разходите или лимити по потребител. Грешка, цикъл или злоупотребяващ потребител може бързо да натрупа разходи. Задайте лимит при доставчика и ограничете заявките за потребител във вашето приложение.
• Изпращане на всичко при всяка заявка. Цели документи и цялата история на чата умножават входните токени. Съкращавайте, обобщавайте по-старите съобщения или извличайте само релевантните части.
• Сляпо доверие в изхода. Моделите могат уверено да кажат неверни неща. За факти, цени или нещо юридическо или медицинско, базирайте отговорите на собствените си данни и показвайте източници, или нека човек провери.
• Позволяване на потребителския вход да заобикаля правилата ви. Потребителите могат да напишат „игнорирай инструкциите си“. Пазете правата и чувствителните действия в сървърния код, не само в подканата.
• Започване с най-големия модел. Пробвайте първо по-малък, по-евтин модел; преминете към по-голям само ако качеството го изисква.
• Изпращане на лични данни без да се замисляте. Проверете условията за използване на данните при доставчика, особено при безплатните планове, и изпращайте само това, което функцията изисква.

Какво да поискате от инструмента си за създаване на приложения

Добави бутон „Обобщи“ на страницата със сигнала. Той извиква сървърен маршрут, който използва тайната OPENAI_API_KEY (никога не се излага на браузъра), проверява дали потребителят е влязъл, изпраща текста на сигнала със следната системна подкана: […], ограничава отговора до 300 токена, предава отговора към страницата поток по поток и показва приятелско съобщение за грешка, ако извикването се провали. Записвай използваните токени за всяка заявка и ограничи всеки потребител до 30 обобщения на час.

За пълноценно чат преживяване вижте как да създадете приложение чатбот с ИИ; за други идеи — как да добавите AI функции към приложението си. Ако API-тата като цяло са ви нови, започнете с какво е API.

LLM API в приложения, създадени с Mythex

Когато строите с Mythex, ИИ вътре в приложението ви използва собствения ви ключ на доставчика. Добавяте го като тайна на проекта или през картата с тайни, която Mythex показва в чата, когато е нужна, и помолете агента да направи извикването на сървъра. Използването на доставчика се таксува във вашия профил при доставчика, не с кредити за строене в Mythex. Mythex не включва токени за потребителите на приложението ви или вграден продукт за база знания, а лимитите на заявките и контролът на разходите са ваша отговорност за проектиране и тестване. Рецептата в документацията добавяне на AI функции със собствени API ключове съдържа стартова подкана, а страницата AI app builder показва откъде да започнете.

Въпроси