Документація · Огляд

API для розробників

Фото, відео, покращення фото, музика й тексти — тими самими моделями й за ті самі кредити, що й у кабінеті. REST і JSON, один ключ у заголовку, жодних SDK.

Адреса: https://aikreator.online/api/v1
Формат: JSON у запиті й відповіді, UTF-8
Оплата: кредити з балансу власника ключа; невдала генерація — безкоштовна

Отримати ключ Поповнити баланс

Перший запит

Фото за 10–20 секунд

curl https://aikreator.online/api/v1/images \
  -H "Authorization: Bearer tr_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "лате на підвіконні, ранкове світло", "ratio": "4:5", "wait": true}'

Спробуйте просто тут

Запити йдуть на справжній API з вашим ключем. Запити на читання безкоштовні; створення фото, відео чи тексту списує кредити, як у кабінеті.

Ключ API

Ключ живе лише в цій вкладці й нікуди, крім API, не надсилається.

Баланс Інструменти й ціни Мої генерації Текст · 2 кр. Фото · 4 кр.

Відповідь—

Натисніть «Надіслати запит»

Ключ API

Ключ створюється в кабінеті, розділ «API і ключі». Його показують один раз — збережіть у змінній середовища на сервері. Передавайте ключ у заголовку Authorization: Bearer tr_live_… (або X-API-Key).

Не вставляйте ключ у код сайту чи мобільного застосунку: хто його побачить, той витрачатиме ваші кредити. Якщо ключ потрапив не туди, відкличте його в кабінеті — запити з ним одразу перестануть працювати.

Перевірити ключ і баланс

curl https://aikreator.online/api/v1/account \
  -H "Authorization: Bearer $AI_CREATOR_KEY"

Відповідь200

{ "object": "account", "email": "you@example.com", "credits": 396,
  "key": { "name": "Бот у Telegram", "prefix": "tr_live_Ab12…9xQz" } }

Як працює генерація

Запит. POST на ендпоінт інструмента списує кредити й повертає генерацію зі статусом processing і кодом 202.
Очікування. Опитуйте GET /generations/{id} раз на 2–5 секунд, доки статус не стане done або failed. Або додайте "wait": true — тоді сервер сам дочекається результату (до ~100 секунд) і відповість 200.
Результат. У output.files — посилання на файли, що діють 24 годин; у текстів — output.text у Markdown. Запитайте генерацію ще раз, щоб отримати свіжі посилання.

Фото, покращення й тексти зазвичай готові за 5–40 секунд, музика — за 10–40, відео — за 1–2 хвилини. Якщо генерація не вдалася, статус стане failed, кредити повернуться на баланс, а причина буде в полі error.

Обірвався зв’язок посеред запиту? Передайте заголовок Idempotency-Key з будь-яким унікальним рядком — повтор того самого запиту протягом доби поверне ту саму генерацію й не спише кредити вдруге.

Ціни й баланс

1 кредит ≈ 1 ₴. Кредити ті самі, що в кабінеті: поповнюйте баланс там. Після кожного запиту на створення заголовок X-Balance і поле balance у відповіді показують залишок.

Ендпоінт	Інструмент	Ціна
`POST /images`	Фото	Швидко: 4 кредити за зображення Деталі: 12 кредитів за зображення З написом: 12 кредитів за зображення
`POST /videos`	Відео	4 с: 20 кредитів 6 с: 30 кредитів 8 с: 40 кредитів
`POST /enhance`	Покращення	До 4K: 12 кредитів Інші операції: 5 кредитів
`POST /music`	Музика	Трек 30 с: 6 кредитів Пісня: 12 кредитів
`POST /texts`	Тексти	2 кредити за текст

Фото `POST /images`

Зображення з опису або за фото-зразками. Опис можна писати українською — ми перекладемо його в точний промпт для моделі.

Поле	Тип	Опис
`prompt` обов’язкове	рядок до 1500	Що має бути на фото.
`quality`	рядок	`fast` — швидко, 4 кредити; `pro` — деталі, 12 кредитів; `type` — з написом, 12 кредитів. Типово `fast`.
`ratio`	рядок	`1:1`, `4:5`, `3:4`, `9:16`, `16:9`, `3:2`. Типово `1:1`.
`style`	рядок	`none` — без стилю, `photo` — фото, `product` — предметка, `food` — фуд, `portrait` — портрет, `cinema` — кіно, `3d` — 3d, `flat` — ілюстрація, `anime` — аніме, `watercolor` — акварель, `riso` — ризограф, `poster` — постер.
`count`	число 1–4	Скільки варіантів. Ціна множиться на кількість.
`references`	масив до 4	Фото-зразки: id файлу з попередньої генерації, https-посилання або data URL (див. Зображення на вході).
`wait`	true / false	Чекати на результат у цій самій відповіді.

Два варіанти за зразком

curl https://aikreator.online/api/v1/images \
  -H "Authorization: Bearer $AI_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "та сама чашка на мармуровому столі, студійне світло",
    "quality": "pro", "ratio": "1:1", "count": 2,
    "references": ["https://example.com/cup.jpg"],
    "wait": true
  }'

Відповідь200

{
  "id": "k3Jx9QbT2mVa", "object": "generation", "tool": "image",
  "status": "done", "cost": 24, "title": "Чашка на мармурі",
  "params": { "quality": "pro", "ratio": "1:1", "count": 2, "references": ["Qw8rT…"] },
  "output": { "files": [
    { "id": "Lm2pX…", "type": "image/jpeg", "width": 2048, "height": 2048,
      "url": "https://aikreator.online/f/Lm2pX…?e=…&s=…", "thumbnail_url": "…/thumb?e=…" },
    { … }
  ] },
  "created_at": "2026-10-24T10:00:00.000Z", "finished_at": "2026-10-24T10:00:21.000Z",
  "balance": 372
}

Відео `POST /videos`

Один безперервний кадр зі звуком. Додайте first_frame, щоб відео почалося з вашого зображення — ми обріжемо його під формат.

Поле	Тип	Опис
`prompt` обов’язкове	рядок до 1500	Що відбувається в кадрі, рух камери, звук.
`duration`	число	`4` — 20 кредитів, `6` — 30 кредитів, `8` — 40 кредитів. Типово `4`.
`ratio`	рядок	`9:16`, `16:9`. Типово `9:16`.
`style`	рядок	`none` — без стилю, `cinema` — кіно, `handheld` — влог, `product` — товар, `drone` — дрон, `slowmo` — слоумо, `timelapse` — таймлапс, `anime` — аніме, `stopmotion` — пластилін.
`audio`	true / false	Звук разом із кадром. Типово `true`.
`first_frame`	зображення	Перший кадр: id файлу, https-посилання або data URL.

Запустити й опитувати

curl https://aikreator.online/api/v1/videos \
  -H "Authorization: Bearer $AI_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "дрон пролітає над Карпатами на світанку", "ratio": "16:9", "duration": 6}'
# → 202 {"id": "Vd7…", "status": "processing", "stage": "render", …}

curl https://aikreator.online/api/v1/generations/Vd7… \
  -H "Authorization: Bearer $AI_CREATOR_KEY"

Покращення `POST /enhance`

Обробка готового фото: кадр, люди й обличчя лишаються ті самі. image — id файлу, https-посилання або data URL.

operation	Що робить	Ціна
`upscale`	Відновлює деталі й збільшує до 4096 px	12 кредитів
`retouch`	Шкіра, світло й колір без зміни рис обличчя	5 кредитів
`background`	Переносить предмет чи людину в інше місце. Потрібне поле `instruction`	5 кредитів
`cutout`	Чистий білий фон для каталогу чи маркетплейсу	5 кредитів
`remove`	Прибирає людей, дроти, сміття з кадру. Потрібне поле `instruction`	5 кредитів
`restore`	Подряпини, вицвілі кольори, різкість	5 кредитів
`relight`	Студійне, золота година, неон. Потрібне поле `instruction`	5 кредитів
`edit`	Будь-яка зміна словами. Потрібне поле `instruction`	5 кредитів

Новий фон для товару

curl https://aikreator.online/api/v1/enhance \
  -H "Authorization: Bearer $AI_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/cup.jpg", "operation": "background",
       "instruction": "пастельне рожеве тло з м’якою тінню", "wait": true}'

Музика `POST /music`

Поле	Тип	Опис
`prompt`	рядок до 1500	Яка музика: для чого, настрій, інструменти.
`mode`	рядок	`clip` — трек 30 с, 6 кредитів; `song` — пісня, 12 кредитів.
`genre`	рядок	`Лоуфай`, `Поп`, `Інді`, `Рок`, `Хіп-хоп`, `Електроніка`, `Хаус`, `Джаз`, `Фолк`, `Ембієнт`, `Саундтрек`, `Синтвейв`.
`mood`	рядок	`Спокійний`, `Енергійний`, `Радісний`, `Мрійливий`, `Епічний`, `Романтичний`, `Таємничий`, `Сумний`.
`instrumental`	true / false	Без вокалу. Для `clip` типово `true`.
`lyrics`	рядок до 3000	Свій текст пісні для `song`; без нього текст напише AI.

У відповіді output.files[0] — MP3 з полем duration, у пісень output.lyrics — текст, який проспівала модель.

Трек 30 с

curl https://aikreator.online/api/v1/music \
  -H "Authorization: Bearer $AI_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "фон для ролика про каву", "genre": "Лоуфай", "mood": "Спокійний", "wait": true}'

Тексти `POST /texts`

Пости, сценарії, хуки, описи — 2 кредити за текст. Відповідь у Markdown у полі output.text.

Поле	Тип	Опис
`prompt` обов’язкове	рядок до 4000	Про що текст, для кого, де опублікуєте.
`format`	рядок	`post` — пост, `reels` — сценарій reels, `hooks` — 10 хуків, `caption` — підпис і хештеги, `youtube` — опис youtube, `carousel` — карусель, `ad` — реклама, `product` — опис товару, `email` — розсилка, `plan` — контент-план, `story` — історія, `free` — будь-що.
`tone`	рядок	`friendly` — дружньо, `expert` — експертно, `fun` — з гумором, `bold` — зухвало, `calm` — спокійно.
`length`	рядок	`s` — коротко, `m` — середньо, `l` — довго.
`language`	рядок	`uk` — українська, `en` — english, `pl` — polski, `de` — deutsch.

Сценарій Reels

curl https://aikreator.online/api/v1/texts \
  -H "Authorization: Bearer $AI_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "як бариста готує гарбузовий лате", "format": "reels", "length": "s", "wait": true}'

Статус і результат

GET /generations/{id} — одна генерація. GET /generations?tool=image&limit=20 — останні генерації акаунта, нові зверху (і з кабінету, і через API: поле source). GET /tools — усі параметри й ціни інструментів у JSON.

Поле	Що означає
`status`	`processing` → `done` або `failed`
`stage`	поки генерується: `queued`, `prompt`, `render`, `writing`, `enhance`, `saving`
`cost`	скільки кредитів списано
`output.files`	файли: `id`, `type`, `width`, `height`, `duration`, `url`, `thumbnail_url`
`output.text`	текст у Markdown (тексти)
`note`	якщо частина не вдалася — що саме й скільки кредитів повернуто
`error`	причина, якщо `failed`

Зображення на вході

Поля references, first_frame і image приймають:

id файлу з output.files попередньої генерації — найшвидше, без повторного завантаження;
https-посилання на JPG, PNG чи WebP до 15 МБ (без переадресацій, лише публічні адреси);
data URL: data:image/jpeg;base64,… — тіло запиту до 25 МБ.

Найменший розмір — 200×200 пікселів. Завантажені зразки зберігаються 30 днів.

Помилки

Помилка — це JSON {"error": {"message": "…", "code": "…", "field": "…"}}. Повідомлення — українською, його можна показати людині.

Код HTTP	Коли
`400`	неправильні параметри; `field` підкаже, яке поле
`401`	немає ключа, ключ неправильний або відкликаний (`missing_key`, `invalid_key`, `revoked_key`)
`402`	на балансі не вистачає кредитів (`no_credits`)
`403`	пошта акаунта не підтверджена (`unverified`)
`404`	генерацію або файл не знайдено (`not_found`)
`413`	зображення або тіло запиту завелике
`429`	забагато запитів; заголовок `Retry-After` — через скільки секунд повторити
`5xx`	збій на нашому боці; кредити за невдалу генерацію повертаються

Ліміти

60 запитів на хвилину для одного ключа, з них до 20 генерацій.
До 10 активних ключів на акаунт; журнал запитів і витрати кожного ключа — у кабінеті.
Посилання на файли діють 24 годин; самі файли зберігаються, доки ви їх не видалите в кабінеті.

Спробуйте просто тут

Ключ API

Як працює генерація

Ціни й баланс

Фото POST /images

Відео POST /videos

Покращення POST /enhance

Музика POST /music

Тексти POST /texts

Статус і результат

Зображення на вході

Помилки

Ліміти

Фото `POST /images`

Відео `POST /videos`

Покращення `POST /enhance`

Музика `POST /music`

Тексти `POST /texts`