Генерация изображений и видео агентом OpenClaw

Чтобы использовать иллюстрацию на странице, агенту нужен готовый файл. Skill API Hubs проводит асинхронную задачу от проверки параметров и оценки цены до завершения. Запрос создаётся один раз; состояние позволяет продолжить его после обрыва связи. Музыка доступна через тот же каталог.

Скачать skill и примеры. Подключение ключа описано в настройке OpenClaw.

Первая задача

Задания и JSON-запросы находятся в examples/ архива. Отправка сообщений и публикация страницы требуют отдельного поручения пользователя.

Оценка точного запроса

Из каталога распакованного пакета получите актуальную inputSchema модели. Поля публичного API записываются в camelCase. На API Hubs:

python3 skills/api-stock-media/scripts/api_stock.py --site apihubs catalog --model nano-banana-2.1
python3 skills/api-stock-media/scripts/api_stock.py --site apihubs estimate \
  --request examples/product-page/image-request.json

Для API Hubs уберите --site apihubs. Оценка возвращает costMicroUsd в миллионных долях USD и costUsd в USD. Она не создаёт задачу. Пробного баланса может не хватить на выбранную генерацию. Тарифы есть на странице цен, а авторизованный запрос учитывает вашу цену.

Согласованный предел расходов

Следующая команда использует пример согласованного предела. Это не обещание стоимости каждой иллюстрации:

python3 skills/api-stock-media/scripts/api_stock.py --site apihubs run \
  --request examples/product-page/image-request.json \
  --state product-image-task.json \
  --max-cost-usd 0.05 --confirm-paid --timeout 60

Скрипт сравнивает оценку с пределом и передаёт его серверу. Перед отправкой запроса он сохраняет ключ идемпотентности. Один файл состояния относится к одной логической генерации. Токены модели, управляющей агентом, оплачиваются отдельно и этим пределом не ограничены.

Восстановление после обрыва

Сохраните JSON-запрос и файл состояния. Повторите ту же команду. Если ответ на создание потерян, тот же ключ вернёт существующую задачу. Новый ключ для восстановления связи не нужен. Если процесс был убит и оставил .lock, убедитесь, что он завершён, прежде чем удалять только lock-файл. JSON состояния сохраните.

Известную задачу можно опрашивать без нового списания:

python3 skills/api-stock-media/scripts/api_stock.py --site apihubs wait TASK_ID --timeout 60

waiting означает окончание локального ожидания: удалённая задача ещё может выполняться. failed и expired — конечные статусы. Для новой генерации после них нужно отдельное решение. Остановка скрипта не отменяет удалённую задачу. Возвраты действуют по правилам API; локальный таймаут ожидания сам по себе не является неуспешной генерацией.

Использование результата

Это изображение получено в живой проверке 2 ноября 2026 года. OpenClaw 2026.10.9 использовал GPT 6 Luna для вызова скрипта. Первая попытка агента указала неверный хост исполнения; после уточнения аргументов вторая создала одну задачу изображения и получила готовый результат. На обе попытки пришлось четыре LLM-запроса. Один запуск не устанавливает качество или надёжность модели в целом.

Точный промпт изображения:

A single orange paper lantern on a midnight blue studio background, folded paper texture, soft side light, generous empty space around the lantern, editorial product illustration, no text, no logos

В исходном запросе было неподдерживаемое поле aspectRatio. Сервер проигнорировал его и использовал size: "16:9" по умолчанию. Текущий пример явно задаёт size; выше сохранён результат исходного запуска.

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

После finished прочитайте files[].fileUrl и output. Некоторые действия возвращают только структурированные данные. Скачайте файл отдельным запросом без API bearer-ключа и используйте его локально. Запишите модель, идентификатор, статус и оценку. Фактическое списание указывайте только при наличии наблюдения.

Сценарий страницы сохраняет HTML и evidence.json. Сценарий публикации — черновики и отдельные записи по обложке и видео. Отсутствующие результаты и ошибки должны быть видны в отчёте агента.

Подробности: статусы задач, ошибки API и выбор модели для агента.