Przejdź do treści
Qamera AI
Wypróbuj za darmo

Довідник інструментів

Усі інструменти, які MCP-сервер Qamera AI надає вашому AI-асистенту — згруповані за задачами, з параметрами та описом того, що вони повертають.

Ваш AI-асистент побачить ці інструменти, щойно ви під'єднаєте його до Qamera AI за допомогою ключа API. Ми згрупували їх за задачами, у яких вони стають у пригоді, а не за будовою сервера.

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

Перш ніж почати

Два набори дозволів. Більшість інструментів потребує дозволу content.register на ключі API. Два інструменти для статусу замовлень наприкінці цієї сторінки потребують content.read. Якщо створити ключ лише з одним із них, більшість роботи асистента виконається, а перевірка статусу повертатиме помилку — у Налаштуванні описано, як обрати обидва.

Списки повертають найновіші позиції та мають обмеження. Шість списків із контентом — продукти, моделі, сценерії, зображення з фотосесій, пекшоти та відео — приймають limit (від 1 до 500, за замовчуванням 50). Два інструменти відхиляються від цього правила: list_recent_generations приймає limit від 1 до 50 зі значенням 20 за замовчуванням, а get_presets приймає maxRecords замість limit, теж 20 за замовчуванням. Кожен запис нижче подає власні межі.

Якщо серверу довелося скоротити список, у відповіді з'являється блок truncated із зазначенням, скільки рядків надійшло і як звузити пошук. Відсутність цього блоку означає, що нічого не було відрізано дорогою до асистента.

Списки не містять зображень. Вони повертають ідентифікатори, назви та статуси. Щоб асистент справді подивився на зображення, він користується одним із двох інструментів попереднього перегляду — саме вони повертають сам знімок.

Генерування витрачає кредити. Усе, що називається register_…, створює замовлення. Перегляд списків, попередні перегляди та оцінювання — безкоштовні.

Продукти

Продукт — це одне або кілька зображень тієї самої речі, завантажених до вашого робочого простору. Усе інше — пекшоти, фотосесії, відео — створюється на основі продукту.

register_product

Завантажує зображення та реєструє їх як один продукт. Це перший крок будь-якого генерування: без продукту немає з чого генерувати.

Параметри:

  • images (масив, обов'язковий) — від 1 до 10 адрес зображень (http або https). Усі вони утворюють один продукт, а не по продукту кожне.
  • name (текст, необов'язковий) — назва продукту, наприклад «Лляна сорочка, екрю».
  • productType (текст, необов'язковий) — категорія, наприклад «купальники».

Повертає: зареєстрований продукт разом з ідентифікатором, який використовує кожен наступний крок.

Дві речі, які варто знати. Продукт не готовий до генерування в мить, коли інструмент повертає відповідь: платформа спершу аналізує зображення, і статус проходить шлях UPLOADED → DESCRIBING → DESCRIBED. Асистент перевірить це через get_products. Крім того, повторний виклик для того самого зображення створить два продукти, бо кожне завантаження вважається новим матеріалом.

get_products

Виводить продукти у вашому робочому просторі, починаючи з найновіших.

Параметри:

  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

Повертає: ідентифікатор, назву, статус і дату створення кожного продукту.

update_product

Виправляє назву або категорію продукту. Нічого не генерує і не витрачає кредитів.

Параметри:

  • productId (текст, обов'язковий) — ідентифікатор продукту.
  • name (текст, необов'язковий) — виправлена назва.
  • productType (текст, необов'язковий) — виправлена категорія.

Моделі

Моделі — це створені штучним інтелектом постаті, які можуть представляти ваш продукт.

get_models

Виводить моделі, доступні у вашому робочому просторі.

Параметри:

  • statusFilter (текст, необов'язковий) — all (за замовчуванням) або approved.
  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

register_models

Генерує нові моделі за описом. Витрачає кредити.

Параметри:

  • preferences (текст, обов'язковий) — який вигляд мають мати моделі, наприклад «жінка, 25–30 років, природний макіяж, вільна поза».
  • count (ціле число, необов'язковий) — від 1 до 10, за замовчуванням 10.

Сценерії

Сценерії — це створені штучним інтелектом тла, на яких розміщується продукт.

get_sceneries

Виводить сценерії, доступні у вашому робочому просторі.

Параметри:

  • statusFilter (текст, необов'язковий) — all (за замовчуванням) або approved.
  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

register_sceneries

Генерує нові сценерії за описом. Витрачає кредити.

Параметри:

  • preferences (текст, обов'язковий) — тло, якого ви очікуєте, наприклад «бетонна тераса у пообідньому сонці».
  • count (ціле число, необов'язковий) — від 1 до 10, за замовчуванням 10.

Фотосесії

Фотосесія розміщує продукт у сценерії — за бажанням із моделлю — і створює набір зображень для вашої оцінки.

register_photo_shoot

Замовляє фотосесію. Витрачає кредити.

Параметри:

  • productId (текст, обов'язковий) — продукт, який треба зняти.
  • aspectRatio (текст, обов'язковий) — одне зі значень: match_input, 9:16, 16:9, 1:1, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9.
  • modelId (текст, необов'язковий) — модель.
  • sceneryId (текст, необов'язковий) — тло.
  • presetId (текст, необов'язковий) — пресет стилю, якого має дотримуватися генерування.
  • industry (текст, необов'язковий) — галузь продукту, наприклад «мода».
  • suggestions (текст, необов'язковий) — побажання власними словами, наприклад «м'яке денне світло, ракурс трохи згори».
  • count (ціле число, необов'язковий) — від 1 до 20 зображень.

Повертає: ідентифікатор замовлення. Генерування триває у фоні — за поступом стежить check_generation_status.

get_images

Виводить зображення, створені у фотосесіях.

Параметри:

  • statusFilter (текст, необов'язковий) — all (за замовчуванням) або approved.
  • productId (текст, необов'язковий) — лише зображення одного продукту.
  • orderId (текст, необов'язковий) — лише зображення з одного замовлення.
  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

get_image_preview

Повертає одне зображення, щоб асистент справді його побачив і прокоментував.

Параметри:

  • recordId (текст, обов'язковий) — ідентифікатор зображення.
  • tier (текст, необов'язковий) — medium (близько 1024 px, за замовчуванням) або full (оригінал).

update_image

Зберігає вашу оцінку одного зображення з фотосесії.

Параметри:

  • recordId (текст, обов'язковий) — ідентифікатор зображення.
  • voting (текст, обов'язковий) — accepted, rejected або pending, щоб скасувати попередню оцінку.

Зверніть увагу на слова. Зображення з фотосесій використовують accepted / rejected, а пекшоти — APPROVED / REJECTED. Це два окремі словники, і вони не взаємозамінні.

Пекшоти

Пекшот — це чисте зображення продукту, зазвичай на однорідному тлі, призначене для картки товару в магазині.

register_packshots

Замовляє генерування пекшотів. Витрачає кредити.

Параметри:

  • productId (текст, обов'язковий) — продукт, який треба зняти.
  • presetId (текст, необов'язковий) — пресет стилю.
  • sceneryId (текст, необов'язковий) — тло.
  • modelId (текст, необов'язковий) — модель.
  • count (число, необов'язковий) — за замовчуванням 10, щонайбільше 50.

Повертає: ідентифікатор замовлення.

get_packshots

Виводить створені пекшоти.

Параметри:

  • statusFilter (текст, необов'язковий) — all (за замовчуванням) або approved.
  • orderId (текст, необов'язковий) — лише пекшоти з одного замовлення.
  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

get_packshot_preview

Повертає один пекшот як зображення, щоб асистент оцінив його ще до вашого затвердження.

Параметри:

  • recordId (текст, обов'язковий) — ідентифікатор пекшота.

update_packshot

Зберігає вашу оцінку пекшота або переносить його до архіву.

Параметри:

  • recordId (текст, обов'язковий) — ідентифікатор пекшота.
  • voting (текст, необов'язковий) — APPROVED або REJECTED.
  • status (текст, необов'язковий) — ARCHIVE, щоб заархівувати пекшот.

Відео

register_video

Створює коротке відео з одного зображення, яке ви вже маєте. Витрачає кредити.

Параметри:

  • generatedImageId (текст, необов'язковий) — зображення з фотосесії.
  • imageId (текст, необов'язковий) — зображення з вашої бібліотеки.
  • suggestion (текст, необов'язковий) — побажання для AI, наприклад «повільне наближення, продукт лишається в центрі».
  • provider (текст, необов'язковий) — постачальник генерування відео; лишіть порожнім, якщо не маєте причини змінювати.

Обов'язковим є один із параметрів: generatedImageId або imageId.

get_videos

Виводить створені відео разом з адресою готового файлу.

Параметри:

  • limit (ціле число, необов'язковий) — від 1 до 500, за замовчуванням 50.

Пресети

Пресет — це збережений стиль: вказівки, якими керується генерування щодо якості та кількості. Каталог спільний, тому пресети, підготовлені Qamera AI, доступні в кожному робочому просторі поряд із тими, які ви створите самі.

get_presets

Виводить пресети з полями, потрібними для вибору: ідентифікатор, назва, чи потрібна сценерія, категорія та теги. Довгі тексти вказівок навмисно пропущено — повний каталог не вмістився б в одну відповідь.

Параметри:

  • maxRecords (число, необов'язковий) — за замовчуванням 20.

Поле scenery має значення. required означає, що без сценерії пресет не дасть розумного результату. recommended означає, що за її відсутності буде використано значення за замовчуванням. null означає, що цей пресет ще ніхто не переглянув, — сприймайте це як відсутність інформації, а не як «сценерія не потрібна».

get_preset

Повертає один пресет повністю, разом із текстами вказівок, яких немає в get_presets.

Параметри:

  • presetId (текст, обов'язковий) — ідентифікатор пресета, скопійований без змін із get_presets.

create_preset

Створює пресет, що належить вашому робочому простору.

Параметри:

  • name (текст, обов'язковий)
  • quantityGuidelines (текст, обов'язковий) — скільки матеріалу та якої різноманітності має постати.
  • qualityGuidelines (текст, обов'язковий) — який результат вважається добрим.

update_preset

Оновлює пресет, що належить вашому робочому простору. Спільні пресети редагувати не можна.

Параметри:

  • presetId (текст, обов'язковий)
  • name (текст, необов'язковий)
  • quantityGuidelines (текст, необов'язковий)
  • qualityGuidelines (текст, необов'язковий)
  • existingGalleryIds (масив, необов'язковий) — вкладення галереї, які треба зберегти.
  • removeCover (логічне значення, необов'язковий) — встановіть true, щоб прибрати обкладинку.

Замовлення та статус

Кожен інструмент register_… повертає ідентифікатор замовлення. Ці два інструменти стежать за тим, що з ним сталося. Обидва потребують дозволу content.read на ключі API.

check_generation_status

Показує одне замовлення докладно.

Параметри:

  • orderId (текст, обов'язковий) — ідентифікатор, який повернув інструмент register_….

Повертає: стан усього замовлення — pending, in_progress, completed, failed або cancelled — розподіл на окремі завдання із зазначенням використаної моделі та можливої помилки, адреси готових файлів і позначки часу.

list_recent_generations

Виводить останні замовлення, починаючи з найновіших. Стає у пригоді, коли ідентифікатор замовлення загубився.

Параметри:

  • status (текст, необов'язковий) — pending, in_progress, completed, failed або cancelled.
  • limit (ціле число, необов'язковий) — від 1 до 50, за замовчуванням 20.
  • since (текст, необов'язковий) — позначка часу ISO 8601; лише замовлення, створені після неї.

Повертає: підсумок кожного замовлення. По подробиці одного замовлення та по адреси файлів звертайтеся до check_generation_status.