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

Эта инструкция предназначена для API, CLI и MCP. Если вы работаете в браузере, начните с [загрузки файла в Studio](/docs/knowledge/guides/studio-files.md).

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

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

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

Для 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 можно продолжить готовую задачу:

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

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

Дальше: [MCP upload и delivery](/docs/mcp/index.md), [CLI](/docs/artillect-cli.md), [восстановление после обрыва](/docs/knowledge/questions/cancellation-and-recovery.md).