Файлы пользователя и доставка

Эта инструкция предназначена для API, CLI и MCP. Если вы работаете в браузере, начните с загрузки файла в Studio.

Сначала передайте исходные файлы выбранному клиенту, затем запускайте задачу и дождитесь результата. Файл, показанный в переписке, не всегда уже доступен инструменту генерации. Здесь описано, как передать его и получить готовые материалы без лишнего платного запуска.

Выбор подключения — в технической документации.

Файл из чата или компьютера

Для MCP основной путь — request_user_upload → пользователь загружает файлы и завершает пакет → get_user_upload до ready. При collecting пакет ещё не готов: не запускайте задачу по первой частичной загрузке. Сохраните порядок files и Asset IDs. Attachment, видимый модели в контексте, не равен файлу на MCP-сервере; не заменяйте референс его словесным описанием.

Hosted MCP не видит локальный file_path пользователя. Для существующего публичного HTTPS URL используйте upload_file({url}); не отправляйте bytes/base64 в контекст модели. Presigned upload предназначен интеграции, у которой действительно есть bytes и доступный HTTP transport, с последующим finalize. Это не повод просить агент без доступа к файлу придумать base64.

Готовый результат

Дождитесь terminal success и непустых media_urls. Покажите каждый результат средствами реального хоста. Сбой показа или скачивания чинится повторной доставкой существующей задачи, а не новой платной генерацией.

В CLI можно продолжить готовую задачу:

artillect generate wait TASK_ID --out public/assets --json

Команда требует действующего входа и доступного рабочего каталога. Сохраните проверенный локальный путь и project/task IDs; ключи и временные capability URLs в asset manifest не коммитят. Для video/audio/mesh покажите все ссылки явно, если хост не умеет inline preview.

Дальше: MCP upload и delivery, CLI, восстановление после обрыва.