Нейросеть для генерации изображений и видео: API
Нейросеть для генерации изображений и видео в приложении обычно означает два вызова: отдельный для картинки и отдельный для ролика. В Relay модели обоих типов доступны через один API-ключ, но используют разные маршруты и единицы расчёта. Выберите нужный тип результата, проверьте карточку модели и обработайте ответ по схеме соответствующего API.
Как выбрать нейросеть для генерации изображений и видео
Начните с конечного файла. Для иллюстрации статьи нужна модель изображений; для движущейся сцены нужна видеомодель. Способность текстовой модели анализировать картинки не означает, что она генерирует их, а название семейства не подтверждает поддержку обоих типов вывода.
Откройте каталог и отберите модели по типу. Например, nano-banana-2 относится к моделям изображений с протоколом openai_images, а seedance-2.5 к видеомоделям с протоколом videos. Это разные позиции, а не два режима одного ID.
Если ищете нейросеть для генерации картинок и видео ради единого доступа, проверяйте именно оба маршрута приложения. Один ключ упрощает настройку авторизации, но не объединяет схемы запросов и не делает модели взаимозаменяемыми.
Как создать изображение через API
Для генерации картинки Relay принимает POST /v1/images/generations. Ниже запрос одного изображения. Ключ вымышленный; для выполнения передайте свой ключ через окружение серверного процесса.
export RELAY_API_KEY="sk-demo-not-a-real-key"
curl --fail-with-body --max-time 300 https://relay-llm.ru/v1/images/generations \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "Белая керамическая чашка на деревянном столе, мягкий дневной свет, пустой фон без текста",
"n": 1
}' -o image-response.jsonОтвет содержит байты изображения в data[].b64_json. Не ищите в нём обязательный публичный URL: документация Relay описывает выдачу base64. После успешного curl декодируйте первый результат:
import base64
import json
from pathlib import Path
response = json.loads(Path("image-response.json").read_text(encoding="utf-8"))
encoded = response["data"][0]["b64_json"]
Path("image.bin").write_bytes(base64.b64decode(encoded, validate=True))Расширение .bin в примере не предполагает формат кодека. Определите фактический тип изображения перед сохранением с нужным расширением или публикацией в приложении. Параметры размера и формата сверяйте с выбранной моделью, а общую схему с Images API.
Чем получение видео отличается от картинки
Для ролика используется POST /v1/videos. В текстовом сценарии передайте ID видеомодели, описание действия, seconds и при необходимости size. Не отправляйте ID nano-banana-2 на видеомаршрут: модель изображений не станет видеомоделью от смены адреса.
POST возвращает ID задачи со статусом queued. Сохраняйте ID и опрашивайте GET /v1/videos/{id}. После completed скачайте MP4 через GET /v1/videos/{id}/content с авторизацией; до этого момента готового результата нет.
Задача хранится 30 минут после создания. Для длительного использования сохраните собственную копию сразу после completed. Полный цикл создания, опроса и скачивания приведён в примере Seedance, а поля и ошибки в Videos API.
Можно ли превратить созданную картинку в ролик
Для такого сценария нужна видеомодель, принимающая изображение, и подтверждённая схема передачи исходника. Не считайте готовую картинку автоматическим входом следующего запроса. Обычный prompt с описанием чашки не передаёт байты или ссылку на изображение.
В каталоге Relay есть модели с обозначением i2v, но общий видеоконтракт не устанавливает единое поле исходного изображения для всех моделей. Прежде чем писать код, проверьте схему выбранной модели. Без этой проверки не добавляйте в запрос придуманное image_url или другое поле только по аналогии с соседним API.
Если пока нужен набор независимых материалов, создавайте иллюстрацию и видео по согласованным текстовым описаниям. Это не гарантирует одинаковую геометрию предмета в двух результатах. Для обязательного сохранения внешнего вида потребуется отдельно подтверждённый сценарий с изображением на входе.
Как сравнить качество и стоимость двух типов генерации
Для картинки проверьте композицию, края предмета, случайные буквы и возможность кадрирования под вашу страницу. Для видео дополнительно смотрите движение и сохранение деталей во времени. Удачный начальный кадр не компенсирует деформацию объекта в конце ролика.
Платная нейросеть для генерации изображений и видео требует разных расчётов бюджета. В Relay картинки оплачиваются за полученные изображения, видео за секунды готового ролика. Ставки смотрите на странице цен, фактический итог в журнале запросов.
Сложите затраты на оба результата и все оплаченные повторы. Если картинку утвердили сразу, а ролик пришлось делать заново, стоимость пары не равна цене двух первых запросов. Задача failed и успешно созданный, но отклонённый вами материал учитываются по-разному.
Ограничьте расходы отдельного тестового ключа. При обрыве клиента не запускайте генерацию повторно вслепую: запрос мог продолжить работу. Сначала проверьте журнал и, если получен ID видеозадачи, её текущий статус.
Есть ли в Relay нейросеть для генерации изображений и видео?
В каталоге есть модели обоих типов. Выбирайте отдельные ID и маршруты для изображений и роликов; общий ключ не делает их одной моделью.
Можно ли использовать один ключ для картинки и ролика?
Можно, если обе модели разрешены настройками ключа и запрос проходит ограничения аккаунта, баланса и расходов.
Почему в ответе изображения нет ссылки?
Images API Relay возвращает base64 в data[].b64_json. Декодируйте байты и сохраните файл в своём приложении.
Можно ли сразу отправить картинку в любую видеомодель?
Нет. Нужны подтверждённая поддержка изображения на входе и схема его передачи для конкретной модели. Текстовый промпт не заменяет исходный файл.