К содержимому
Блог

Нейросеть для генерации изображений и видео: API

Нейросеть для генерации изображений и видео: API

Нейросеть для генерации изображений и видео в приложении обычно означает два вызова: отдельный для картинки и отдельный для ролика. В Relay модели обоих типов доступны через один API-ключ, но используют разные маршруты и единицы расчёта. Выберите нужный тип результата, проверьте карточку модели и обработайте ответ по схеме соответствующего API.

Как выбрать нейросеть для генерации изображений и видео

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

Откройте каталог и отберите модели по типу. Например, nano-banana-2 относится к моделям изображений с протоколом openai_images, а seedance-2.5 к видеомоделям с протоколом videos. Это разные позиции, а не два режима одного ID.

Nano Banana 20,13 $ за изображение
Seedance 2.50,425 $ за секунду видео

Если ищете нейросеть для генерации картинок и видео ради единого доступа, проверяйте именно оба маршрута приложения. Один ключ упрощает настройку авторизации, но не объединяет схемы запросов и не делает модели взаимозаменяемыми.

Как создать изображение через API

Для генерации картинки Relay принимает POST /v1/images/generations. Ниже запрос одного изображения. Ключ вымышленный; для выполнения передайте свой ключ через окружение серверного процесса.

bash
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 декодируйте первый результат:

python
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. Декодируйте байты и сохраните файл в своём приложении.

Можно ли сразу отправить картинку в любую видеомодель?

Нет. Нужны подтверждённая поддержка изображения на входе и схема его передачи для конкретной модели. Текстовый промпт не заменяет исходный файл.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.