Features: студия через API и MCP

Нужны только модели для кода/чата — подключите Provider. Нужны только медиа у уже настроенного агента — подключите MCP, менять его LLM не обязательно.

Оба подключения полезны для лендинга с оригинальными фото, рекламного комплекта с видео/озвучкой или игровых ассетов: агент связывает код и медиа, а проект сохраняет результат для Studio.

Provider — LLM inference: Chat Completions, Responses, Anthropic Messages; возвращает ответы и предложения tool calls, сам инструменты не исполняет.

MCP — инструменты Artillect: каталог, estimate, генерация изображений/видео/аудио/3D, get_task, проекты и доставка ассетов.

Harness (Hermes, OpenCode и другие клиенты) — агентский цикл: вызывает инструменты, а при наличии разрешённых shell/files пишет код и скачивает файлы.

Поиск публичной справки: https://app.artillect.pro/knowledge/#knowledge-search ; рецепты MCP: https://app.artillect.pro/docs/mcp/recipes.md . Поиск не читает личные проекты и файлы.

Подключения независимы: MCP работает с другим LLM-провайдером; Provider работает без MCP и без генерации медиа. Вместе дают агенту модели и медиаматериалы одного сервиса.

Setup: /provider/, /provider/hermes/, /provider/opencode/; MCP: /docs/mcp; API-ключ: /api/. Provider URL https://app.artillect.pro/api/v1/provider; MCP URL https://app.artillect.pro/mcp.

Для совместного API-key setup: provider:write, models:read, images:write (также audio/mesh), videos:write, projects:write. files:write — для загрузки медиа и текстовых документов в хранилище. MCP отдельно поддерживает OAuth. Ключи не публикуйте и не коммитьте.

Хранилище доступно через Public API, MCP и CLI. Можно хранить инструкции агентов (AGENTS.md), описания skills (SKILL.md) и сопроводительные Markdown/TXT-файлы: UTF-8, до 10 МиБ на документ. REST: POST /api/v1/files/ или /files/from-url/, GET /api/v1/assets/?kind=file, GET/POST/DELETE /api/v1/assets/{asset_id}/. MCP: upload_file, list_media_assets, get_media_asset, copy_media_asset, delete_media_asset. CLI: upload, assets list/get/download/copy/delete. Сохраняйте ast_…; URL для скачивания получайте заново. Хранение файлов не запускает агента и не устанавливает skill; применение инструкций выполняет клиент.

Контекст Provider: приложение хранит историю и отправляет нужные сообщения в каждом запросе. Prompt caching выполняет провайдер модели через OpenRouter; Artillect не подменяет его собственной памятью диалога. В Chat Completions для anthropic/* без явных настроек добавляется cache_control: ephemeral; явные настройки клиента сохраняются. В native Messages/Responses клиент передаёт настройки своего протокола. Cache hit зависит от модели, совпадения префикса, срока жизни и маршрута; session_id/X-Session-Id помогает закрепить маршрут, но не восстанавливает историю. Фактические cached_tokens/cache_write_tokens и usage.cost отражают чтение/запись кэша. Файл в хранилище не становится кэшем контекста автоматически.

Бесплатно напрямую: GET /api/v1/provider/models/, GET /api/v1/me/; MCP initialize/tools list, get_started/get_balance. Это auth/discovery, не проверка платного inference. Сообщение LLM-агенту оплачивается, даже если инструмент бесплатный.

Provider использует личный накопительный ledger: округляется общая стоимость, новый запрос списывает её прирост. Старые запросы остаются по прежней политике. Studio/media тарифы не меняются; project media может использовать другой баланс. Общего автоматического жёсткого бюджета LLM+media нет.

GET /api/v1/provider/requests/?id=<X-Artillect-Request-Id> с тем же user/API key и provider:write показывает исход и расчёт. Status lookup не воспроизводит ответ; inference idempotent replay отсутствует. При неоднозначном обрыве сначала status, не слепой retry.

MCP image/poster blocks предназначены user+assistant, но передачу байтов модели и показ превью решает host. Нужны vision-модель и поддержка клиента; сервер не гарантирует одинаковый UI или автоматическое зрение.

Studio Assistant направляет запросы на создание сайта или целого приложения к Artillect Provider в Hermes/OpenCode; не пишет целое приложение в чате. Он объясняет подключение и помогает подготовить задачу; для медиа предлагает MCP. Его catalog tools не устанавливают конфиги и не исполняют shell/deployment; generation offers подтверждаются через UI. Внешний агент пишет код и собирает проект в пределах своих прав и бюджета.

Каждый запрос Provider получает короткий контекст Artillect и условных возможностей MCP. Он сохраняет инструкции клиента; наличие контекста не подключает MCP и не добавляет инструментов. Дополнительный вход учитывается в резерве и фактической стоимости LLM.

/storage — загрузка, поиск и скачивание своих файлов и результатов. Проектные файлы доступны по правам проекта.

Храните инструкции агентов AGENTS.md, определения skills SKILL.md и другие Markdown/TXT-документы в UTF-8, до 10 МиБ. Сохранение не запускает агента и не подключает инструкции к модели автоматически.

Public API: POST /api/v1/files/, GET /api/v1/assets/?kind=file, GET/POST/DELETE /api/v1/assets/{asset_id}/. MCP: upload_file, list_media_assets, get_media_asset, copy_media_asset, delete_media_asset. CLI: upload, assets list/get/download/copy/delete.

Публичные ссылки для передачи файлов вне проекта пока не реализованы.

Архив и корзина открываются шторкой из проводника, нижнего меню и хранилища; полные страницы /projects/archive и /projects/trash.

Архивный проект можно вернуть в проводник. Удалённый проект можно восстановить в течение 7 дней; окончательное удаление необратимо.

Автоматическая очистка и физическое освобождение media требуют работающих purge workers; наличие корзины не доказывает, что worker включён. Не обещайте освобождение байтов сразу после скрытия строки.

Поля профиля сохраняются на сервере. Уникальный никнейм задаёт адрес /u/{nickname}; публичная страница доступна только при включённой публикации профиля.

На публичной странице показываются имя, никнейм, аватар и выбранные сведения профиля; email, баланс и личные файлы не публикуются. Существующие аккаунты по умолчанию приватны.

Кредиты = Studio. Device flow для CI. HTTP /mcp без Bearer/OAuth → 401 (нет env-fallback).

get_me — кто владелец ключа; тот же identity, что Studio.

429 SPEND_CAP_EXCEEDED / RATE_LIMITED — остановите параллельные submit.

estimate type=audio|mesh без prompt отдаёт flat cost (DX).

recommend_model = эвристика; источник правды = GET /models / list_models.

Public API, MCP и CLI поддерживают один CRUD lifecycle; transport names могут отличаться.

Личный hub удалять нельзя.

GET roles · members CRUD · PATCH me (is_favorite). MCP и CLI используют те же member operations.

На generate_*: project_id + billing_source. GET …/analytics/ и …/billing/ — REST.

GET /projects/{id}/generations/ — главный Studio-паритет: q (≥2), tag_ids (AND), date/date_from/date_to, mine_only, source, kind.

GET /{images|videos|…}/generations/ — плоская история ключа с общими status/job_id/source/date filters.

MCP и CLI передают те же list filters (включая q/date/status/job_id); API остаётся каноническим transport contract.

Grouping / feed meta (author|date|service|tag) — только Studio UI, не Public API.

Как цветные метки в Studio. До 10 custom на проект, имя ≤10 символов. Лайки/архив — не в tag_ids.

Пайплайн: create_project_tag / POST …/tags/ → generate_* с project_id + tag_ids → тег сразу на новой gen.

Неверный tag id молча пропускается (submit не падает).

Like ≠ custom tag. Favorites list проекта + system slug **favorite** через assign_generation_tags.

В меню карточки генерации выберите «Повторить». Откроется соответствующий генератор; он восстановит модель, промпт и доступные исходные параметры и медиа из сохранённого запроса.

Повторить не запускает платную генерацию автоматически. Перед новым запуском проверьте восстановленные настройки и актуальную цену: каталог моделей или доступность исходных файлов могли измениться.

Перенос и копирование между проектами — отдельные действия. Повторить создаёт новую задачу, а не переносит старый результат; идентичный результат не гарантируется.

copy_generation → новый объект в destination; move_generation меняет project_id.

Move снимает теги (strip on move). delete_generation — hard-delete (осторожно).

kind image|video + media_json. Soft-delete: delete_project_element. Gemini/audio create — не в Public API.

Предпочтительнее чужих хостов: меньше SSRF-отказов.

OmniHuman 2.0: выберите «Говорящий аватар», добавьте одно фото и аудио 4–300 секунд. Результат 720p; в настройках можно выключить водяной знак. OmniHuman 1.5 остаётся отдельным вариантом с 1080p.

PixVerse V6 Max: генерация по тексту или начальному кадру, 1–15 секунд, 360p/540p/720p/1080p, звук по желанию и Seed, включая 0. При начальном кадре пропорции определяются изображением.

HeyGen Video создаёт видео с нативным звуком: текст, один начальный кадр или до 9 изображений, 3 видео и 3 аудиореференсов. Длительность 5–15 секунд, 480p/768p/1080p/2K; кадровый и референсный режимы разделены. Доступны улучшение промпта, Seed и проверка безопасности. Это отдельная модель от HeyGen для липсинка.

VEED Dubbing находится в задаче «Перевести видео»: загрузите видео до 10 минут, выберите язык и обычный режим или Pro. Pro добавляет диалекты и настройку сходства голоса 0–10. В дополнительных настройках можно указать имена и термины. Цена считается по длительности исходного видео.

Недавно добавленные модели получают бейдж NEW в течение 14 дней. Порядок рекомендаций учитывает назначение модели; фильтр задачи сохраняет совместимость входов. Повторить сохраняет новые настройки, включая выключенные переключатели и нулевые значения.

Kling 4: создаёт видео 3–30 секунд в 720p/1080p. В «Раскадровке» задайте до 10 последовательных кадров, но не больше длительности в секундах плюс один. В режиме референсов можно сочетать до 10 изображений, 5 видео, 7 персонажей и 3 голосов — всего до 15 материалов; видео вместе до 30 секунд. Голоса загружаются как аудиореференсы @Audio1–3 и могут привязываться к персонажам. Ключевые кадры и референсы используются отдельно. Без входного видео звук создаётся автоматически; при наличии видео можно сохранить его звук. Стоимость с видео зависит от входной и выходной длительности. Повторить сохраняет кадры, голоса и настройки.

Midjourney: выберите модель в Изображениях и откройте «Инструменты Midjourney» в дополнительных настройках или меню результата. Там доступны смешивание 2–4 фото, редактирование, четыре промпта по фото, увеличение, вариации, повтор сетки, расширение, изменение композиции и редактирование области. Эти операции не занимают отдельные карточки в общем списке идей.

Редактирование области Midjourney: сначала увеличьте результат, затем запустите подготовку. После готовности в течение 30 минут отправьте PNG-маску и описание; прозрачные области меняются, белые сохраняются. Продолжение использует ту же задачу без повторного списания; без маски расширяется кадр.

Midjourney Video оживляет одно загруженное изображение или кадр из своей генерации Midjourney. Ролик около 5 секунд без звука, 480p/720p, спокойное или выраженное движение, 1/2/4 ролика, необязательный последний кадр. Изображение и исходная задача взаимоисключаются; авторежим доступен только для исходной задачи.

Настройки зависят от конкретной модели, операции и поверхности: проверяйте её актуальную карточку и совместимость входных слотов.

Семейный контекст LLM не равен лимиту текущего маршрута; кроме каталога действуют ограничения выбранного продукта.

Откройте дополнительные параметры в генераторе. Названия полей Studio и Public API могут отличаться; для интеграции используйте её reference.

Минимальная цена в каталоге не заменяет оценку выбранного запроса: размер, длительность, качество и референсы могут менять стоимость.

Повторить восстанавливает сохранённые модель, сценарий, порядок входов и настройки, включая seed=0 и false. Ноль не означает отсутствие выбора; Meshy Idle=0 — выбранная анимация.

Повторить не запускает платную задачу автоматически. Проверьте восстановленные файлы, проект и актуальную цену перед новым запуском.

Асинхронный цикл: submit → poll. Не ждите SSE на images.

В /images доступны создание и правка, векторная графика, векторизация, удаление фона, смена ракурса, разложение на слои и примерка одежды. Задача определяет совместимые модели и обязательные входы.

В режиме облачка выбор задачи находится в верхней панели перед проектом. Для задач с отдельными входами используется полная форма; вернуться можно через «Создать или изменить».

Новые идеи добавляют текст к промпту, не выбирают другую модель. Старые ссылки и сохранённые шаблоны сохраняют отдельную миграционную логику.

Ресурс содержит версии весов. В генераторе выбираются конкретная версия и сила применения. Допускаются готовые версии с проверенной структурой или подтверждением провайдера.

Поддерживаемые базы: Z-Image Turbo, Qwen Image 2512, FLUX.2 dev и LTX 2.3. Совпадение названия семейства не означает совместимость: веса Qwen Image 2512 не подходят Qwen Image 3; веса FLUX.2 dev не подходят Pro, Max или Flex.

При переходе на несовместимую модель выбранная LoRA сохраняется, но не применяется. Обучение LTX на фото задаёт внешность и стиль, а не движение или звук.

Public API предоставляет GET /api/v1/loras/ и /api/v1/loras/{id}/ для своих ресурсов. Image/video submit принимает lora_selection {id, version_id, scale} и проверяет владельца, готовность и совместимость. В MCP generate_image/generate_video этот объект передаётся через extra.lora_selection; отдельного инструмента списка LoRA пока нет.

Приватные хосты отклоняются SSRF-гардом.

Каждый submit получает собственный 4-секундный дедлайн и не блокирует следующие генерации.

Отмена допустима только пока задача не ушла провайдеру; после submit provider-side cancel отсутствует.

Дефолт MCP video — kling-3-turbo. Character continuity — Element Library + kling-3 / kling-o3.

Тот же async-паттерн и биллинг.

Audio API включает музыку, речь, клонирование и обработку по объявленным model-operation. Входы и формат результата проверяйте в текущем audio catalog.

Дождитесь результата выбранной операции: аудио/видео-артефактов с URL либо текстовых artifacts. Входной audio_url для avatar/lipsync — отдельная сущность.

Модели и операции 3D различаются по входам и форматам. Используйте текущий mesh catalog; не переносите настройки Meshy на другое семейство. Audio/mesh используют polling.

MCP chat_completion sync. create_chat_conversation → conversation_id на completions сохраняет ход в chat_messages (тот же store, что Studio LLM).

Клиент по-прежнему шлёт полный messages[]; store — persistence, не server-side memory injection.

Лимиты изображений индивидуальны: GET /api/v1/models возвращает max_images_per_message/max_images_total и источник для каждой chat-модели. Общий лимит 4/8 снят; null означает, что числовой потолок не подтверждён. Контекст и payload маршрута OpenRouter могут ограничить запрос раньше. API-тред не обрезает новые вложения до Studio-бюджета 4; запросы с изображениями рассчитываются по фактическому usage.

24h Redis. MCP hosts обычно не шлют ключ.

SSRF-guard на URL. Audio/mesh — poll only. MCP: get/upsert/delete/rotate/deliveries.