Veo 3.1

Видео

Протоколы и возможности

generations, videos

Режимы и параметры

text · text-to-video

Промпт: required; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`resolution`	Разрешение	`"1080p"`	`{ "required": true, "values": [ "720p", "1080p", "4K" ] }`
`duration_sec`	Длительность	`8`	`{ "required": true, "values": [ 4, 6, 8 ] }`
`negative_prompt`	Исключить из кадра	`null`	`{ "required": false }`
`seed`	Зерно	`-1`	`{ "required": false, "min": -1, "max": 2147483647, "step": 1 }`

Фиксированные параметры:

json

{
  "quality": "standard",
  "aspect_ratio": "16:9",
  "audio": true
}

first_frame · image-to-video

Промпт: required; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`resolution`	Разрешение	`"1080p"`	`{ "required": true, "values": [ "720p", "1080p", "4K" ] }`
`duration_sec`	Длительность	`8`	`{ "required": true, "values": [ 4, 6, 8 ] }`
`negative_prompt`	Исключить из кадра	`null`	`{ "required": false }`
`seed`	Зерно	`-1`	`{ "required": false, "min": -1, "max": 2147483647, "step": 1 }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`first_frame`	Первый кадр	—	`{ "media_kind": "image", "required": true, "min_items": 1, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

Фиксированные параметры:

json

{
  "quality": "standard",
  "aspect_ratio": "16:9",
  "audio": true
}

reference · reference-to-video

Промпт: required; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`resolution`	Разрешение	`"1080p"`	`{ "required": true, "values": [ "720p", "1080p", "4K" ] }`
`audio`	Звук	`true`	`{ "required": true }`
`negative_prompt`	Исключить из кадра	`null`	`{ "required": false }`
`seed`	Зерно	`-1`	`{ "required": false, "min": -1, "max": 2147483647, "step": 1 }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`reference_images`	Референсы — изображения	—	`{ "media_kind": "image", "required": true, "min_items": 1, "max_items": 3, "collection": true, "ordered": true, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

Фиксированные параметры:

json

{
  "quality": "standard",
  "aspect_ratio": "16:9",
  "duration_sec": 8
}

Совместимость настроек

json

[
  {
    "allowed": {
      "duration_sec": [
        8
      ]
    },
    "fallback": {
      "duration_sec": 8
    },
    "when": {
      "resolution": "1080p"
    }
  },
  {
    "allowed": {
      "duration_sec": [
        8
      ]
    },
    "fallback": {
      "duration_sec": 8
    },
    "when": {
      "resolution": "4K"
    }
  },
  {
    "allowed": {
      "duration_sec": [
        8
      ],
      "quality": [
        "standard"
      ]
    },
    "fallback": {
      "duration_sec": 8,
      "quality": "standard"
    },
    "when": {
      "mode": "reference"
    }
  }
]

Расчёт стоимости

Цена зависит от выбранных настроек и входных файлов. Калькулятор рассчитывает стоимость без генерации. Для расчёта с файлами используйте POST /v1/generations/quote с API-ключом. Тариф и параметры фиксируются при создании задачи.

Пример запроса

bash

curl "${RENDERFOX_BASE_URL:-https://api.renderfox.ru/v1}/generations" \
  -H "Authorization: Bearer $RENDERFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @request.json

json

{
  "model": "veo-3.1",
  "mode": "text",
  "prompt": "Создай результат по этому описанию.",
  "settings": {
    "resolution": "1080p",
    "duration_sec": 8,
    "seed": -1,
    "quality": "standard",
    "aspect_ratio": "16:9",
    "audio": true
  },
  "inputs": {}
}

Новый логический запрос — новый Idempotency-Key. Сетевой повтор использует прежние ключ и тело. Резерв, списание и возврат FC · Ошибки · Каталог.

Версия тарифа: e583a0cdd10522495e8c182e62525687ae5ddea5fb582eac9319ee97da183633. Версия каталога: d12314f1d1fbe542. Последнее обновление источника: версия опубликованного каталога.