Як підключити OpenAI до Mergado Sources#
Підключення OpenAI до розширення Mergado Sources дає змогу використовувати передові мовні моделі GPT для автоматизованого редагування й генерування текстів безпосередньо у вашому товарному фіді в проєкті в Mergado Editor.
Ціна та ліміти OpenAI API#
Використання OpenAI API платне й оплачується залежно від кількості оброблених токенів (одиниць тексту, де приблизно 1 000 токенів відповідає 750 словам). Плата нараховується як за вхідні дані (промпт), так і за вихідний текст.
Цю плату ви сплачуєте безпосередньо постачальнику (OpenAI), тобто оплата не проходить через Mergado Sources, яке є безкоштовним. Власний API-ключ ви використовуєте для того, щоб платити безпосередньо OpenAI без маржі посередників. Рахунки ви, отже, побачите безпосередньо в адмініструванні OpenAI.
В адмініструванні доступу до API в OpenAI у розділі Usage можна налаштувати ліміт витрат (billing limits), щоб тримати витрати під контролем і не витратити більше, ніж плануєте.
Швидкість обробки запитів OpenAI API може впродовж дня змінюватися й іноді бути значно повільнішою. Якщо дані після перегенерування не з’являться одразу, перегенеруйте проєкт знову через деякий час.
Якщо хочете (орієнтовно) дізнатися, скільки токенів споживе ваш промпт, скористайтеся сервісом OpenAI Tokenizer. Це вебсторінка, куди ви вставляєте свій промпт, а Tokenizer обчислює, скільки токенів у ньому знайшов. Однак пам’ятайте, що підсумкова ціна за OpenAI розраховується з токенів на вході (ваш промпт) і на виході (відповідь від OpenAI).
Як створити підключення до OpenAI?#
1. Активація розширення#
Mergado Sources активуєте в Mergado Store: I want to activate → виберіть проєкт, з яким хочете працювати → Enable.
2. Отримання API-ключа в OpenAI#
- Увійдіть у свій обліковий запис на OpenAI або створіть його, якщо ще не маєте.
- У правому верхньому куті натисніть іконку налаштувань.
- У лівому меню натисніть розділ API Keys.
- Натисніть Create new secret key, назвіть ключ, створіть його, натиснувши Create secret key, а потім скопіюйте.
3. Налаштування в Mergado Sources#
- Відкрийте інтерфейс Mergado Sources і перейдіть на вкладку Data sources.
- Біля джерела OpenAI натисніть кнопку Set up.
- У поле Token вставте скопійований API-ключ і натисніть Save connection.
- Якщо все гаразд, статус підключення зміниться на зелений із повідомленням Connection is active.
Часті запитання#
Що потрібно для підключення OpenAI до Mergado Sources?#
Потрібен обліковий запис на платформі OpenAI, з якого отримаєте API-ключ, і розширення Mergado Sources, активоване для відповідного проєкту в Mergado Editor.
Чи безкоштовне підключення до OpenAI?#
Саме розширення Mergado Sources безкоштовне, але використання OpenAI API платне. Плата розраховується за кількістю оброблених токенів, і сплачуєте її безпосередньо компанії OpenAI. Mergado Sources у ці платежі жодним чином не втручається.
Що таке токени і як розраховується їхня ціна?#
Токен – це одиниця тексту: приблизно 1 000 токенів відповідає 750 словам. Плата нараховується як за вхідний текст (ваш промпт), так і за вихідний текст (відповідь від GPT). Орієнтовну кількість токенів вашого промпту можна перевірити за допомогою інструмента OpenAI Tokenizer.
Як налаштувати ліміт витрат, щоб не перевищити бюджет?#
В адмініструванні OpenAI перейдіть до розділу Usage і налаштуйте ліміт витрат (billing limits). Так ви забезпечите, щоб API перестало відповідати після досягнення встановленого вами ліміту, і не витратите більше, ніж плануєте.
Чому я плачу безпосередньо OpenAI, а не через Mergado?#
Власний API-ключ забезпечує максимальну прозорість – ви бачите, скільки саме і за що платите, безпосередньо у своєму обліковому записі OpenAI. Жодної прихованої маржі для посередників платежу немає.
Де в OpenAI знайти API-ключ?#
Увійдіть на platform.openai.com, у правому верхньому куті натисніть іконку налаштувань і в лівому меню перейдіть до розділу API Keys. Там створіть новий ключ кнопкою Create new secret key, назвіть його і скопіюйте.
Як дізнатися, що підключення до OpenAI працює?#
На вкладці Data sources в інтерфейсі Mergado Sources біля джерела OpenAI побачите зелений статус «Connection is active».
Чому дані не з’явилися одразу після перегенерування?#
Причин може бути кілька. По-перше, проєкт потрібно перегенерувати щонайменше двічі: під час першого перегенерування Mergado Sources дані зчитує, під час другого – записує. По-друге, швидкість обробки OpenAI API може впродовж дня значно відрізнятися. Якщо даних досі немає, перегенеруйте проєкт знову через деякий час.
Чи можна обмежити генерування текстів лише частиною товарів?#
Так. Під час створення елемента оберете конкретну вибірку товарів із Mergado Editor – наприклад, лише товари, у яких відсутній опис. Так ви заощадите витрати на OpenAI API, бо обробляються лише релевантні товари.