Ползвайте AI студиото за продуктови снимки, снимки по описание, блог статии, премахване на фон и SEO Agent
от вашия сайт, магазин или програма. Плаща се с кредитите на акаунта в TapTo — без абонамент.
Вземете токенПрофил в TapTo → AI Услуги → API Интеграция
2
Адрес на API-тоhttps://tapto.bg/api/ai
3
Първа заявкаGET /credits — безплатно е
Автентикация и грешки
Всички адреси започват с
https://tapto.bg/api/ai
Токенът се изпраща в заглавката на всяка заявка:
Authorization: Bearer ВАШИЯТ_ТОКЕН
Ако не можете да пращате заглавки — като параметър ?ai_token=…. Токенът дава достъп до кредитите ви — ползвайте го само от сървъра, не в браузъра.
Отговорите
Винаги JSON с „status“: true при успех. При грешка — „status“: false и причината в „messages“:
401Липсва или е грешен токенът.
402 / 403Няма достатъчно кредити — заредете от „AI кредити“.
422Грешен или липсващ параметър — причината е в „messages“.
500Грешка при генерирането — кредити не се удържат.
Готови класове (TapToAIService)
Свалете клас за вашия език — в него са всички методи от страницата: кредити, AI студио, снимки, фон, блог статии и SEO Agent. Слагате токена и викате методите.
Всички стойности, които приема генерирането: видове продукти (с подходящите им сцени и хора/животни), сцени, светлина, настроение, ъгъл, празник, формат и точност — с ключ и етикет. Покажете ги на потребителя и изпратете ключа.
Параметри в адреса
locale
Език на етикетите: bg, en, de или ro.
Пример
curl -X GET "https://tapto.bg/api/ai/studio/presets?locale=bg" \
-H "Authorization: Bearer ВАШИЯТ_ТОКЕН"
Качвате снимка на продукта и избирате сцена — AI запазва продукта и го поставя в нея, по желание с човек или животно. Описанието за модела се сглобява от избраното, а свободният текст може да е на български (превежда се автоматично). Връща 2 варианта. Ако няма снимка, „product“ е задължително.
Полета на заявката
input_image
Снимка на продукта (файл, до 15 MB). Препоръчително.
product
Какъв е продуктът — задължително без снимка (до 300 знака).
type
Вид продукт — ключ от types (напр. pets, fashion, home).
scene
Сцена — ключ от scenes (напр. white, living, beach).
subject
С кого — ключ от subjects (none, woman, dog…).
format
square, portrait, tall, landscape или classic.
color
Цвят на фона за сцените color, gradient и podium (#hex или име).
lighting
Светлина — ключ от lighting.
mood
Настроение — ключ от moods.
angle
Ъгъл на камерата — ключ от angles.
season
Празник или сезон — ключ от seasons.
fidelity
Колко да прилича на снимката: exact, balanced или free.
extra
Още детайли със свои думи (до 1000 знака).
avoid
Какво да няма на снимката (до 300 знака).
seed
Число за повторяемост — същият seed дава близък резултат.
steps
Стъпки 10–50 (по подразбиране 28).
cfg
Колко стриктно да следва описанието, 1–10 (по подразбиране 3.5).
Генерирането отнема 20–40 секунди — сложете време за изчакване поне 240 секунди.
Една снимка по ваше описание (prompt) — фон, банер, илюстрация или каквото си представите. Описанието може да е на български — превежда се автоматично. За снимки на продукт по-лесно е AI студиото.
Полета на заявката
promptзадължително
Описание на снимката — на български или английски.
model
Качество: quality (по-детайлно, по подразбиране) или fast (бързо, за идеи).
width
Ширина в пиксели (по подразбиране 1024).
height
Височина в пиксели (по подразбиране 1024).
steps
Стъпки — около 28 за quality, 4 за fast (по подразбиране 4).
cfg_scale
Колко стриктно да следва описанието, 1–10.
negative_prompt
Какво да няма на снимката.
output_format
PNG, JPG или WEBP.
input_image
Снимка-ориентир (файл, до 10 MB) — изпраща се като multipart.
Пишете темата — AI пише цялата статия: заглавие, увод, раздели с подзаглавия, списъци, таблица, съвети, въпроси и отговори и заключение, плюс SEO (мета заглавие и описание, ключови думи, OG/Twitter, slug, етикети). По желание и корица в 2 варианта. Писането е на заден план: заявката връща id, по който питате GET /blog-article/{id}. Таксува се само при успех.
Полета на заявката
topicзадължително
Темата на статията (до 300 знака).
keywords
Ключови думи, основната първа.
language
bg, en, de, ro, el, tr, fr, es, it (по подразбиране bg).
length
short (~600 думи), medium (~1200, по подразбиране) или long (~2000).
tone
friendly, expert, selling или simple.
audience
За кого е статията.
notes
Допълнителни указания (до 1000 знака).
cover
true — и корица (2 варианта, хоризонтални, без надписи).
cover_style
photo, illustration, 3d или minimal.
Отговорът идва веднага (202) с id. Статията обикновено е готова за 30–90 секунди — питайте на всеки 4–5 секунди.
Пример
curl -X POST "https://tapto.bg/api/ai/blog-article" \
-H "Authorization: Bearer ВАШИЯТ_ТОКЕН" \
-H "Content-Type: application/json" \
-d '{
"topic": "Как да изберем легло за куче",
"keywords": "легло за куче, кучешко легло",
"language": "bg",
"length": "medium",
"tone": "friendly",
"cover": true,
"cover_style": "photo"
}'
state е pending, done или error. При done има article (всички полета и SEO), html (готово за блога — h2, h3, p, списъци, таблица, blockquote; без H1), images (кориците) и charged.
Пример
curl -X GET "https://tapto.bg/api/ai/blog-article/156" \
-H "Authorization: Bearer ВАШИЯТ_ТОКЕН"
От името, цената и описанието на продукта прави за всеки език: заглавие, мета описание, ключови думи, HTML описание, OG/Twitter тагове, slug и имена/alt текст за снимките.
Полета на заявката
site_nameзадължително
Име на сайта / магазина.
site_urlзадължително
Адрес на сайта (https://…).
languagesзадължително
Езици, разделени със запетая (напр. bg, en).
product_nameзадължително
Име на продукта.
product_priceзадължително
Цена (число).
descriptionзадължително
Описание — може и набързо написано.
currency
Валута: EUR, BGN, USD… (по подразбиране BGN).
images[]
Снимки на продукта (multipart) — за имена и alt текст.
Ние използваме бисквитки, за да подобрим вашето потребителско изживяване на нашия уебсайт.
Те ни помагат да анализираме трафика, да персонализираме съдържанието и да ви предоставим релевантни реклами.
Чрез натискане на "Приемам всички", вие се съгласявате с използването на всички бисквитки.
Можете да управлявате предпочитанията си чрез бутона "Настройки".
Научете повече
Настройки на бисквитките
Изберете вида бисквитки, които искате да приемете. Необходимите бисквитки са задължителни за работата на сайта.
Тези бисквитки са необходими за основната функционалност на сайта и не могат да бъдат деактивирани.
Позволяват ни да анализираме използването на сайта и да го подобряваме.
Използват се за показване на релевантни реклами и маркетинг съдържание.