Создать видео（Seedance）

Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке совместимые форматы видео生成Sora ).

Используется для создания задач генерации видео и получения статуса и результатов по ID задачи.

Основные поля для создания задачи:

• model: Обязательно, название модели.
• prompt: необязательно; если не передано, в content необходимо указать непустой текстовый элемент.
• content: необязательный массив content Volcano Ark, для смешанного размещения текста, изображений, видео и аудио.
• function_mode: Опционально, часто используется в расширенных режимах, таких как универсальный референс.

Совместимые входные параметры:

Следующие поля в основном предназначены для совместимости со старыми клиентами и устаревшими протоколами. Для новых интеграций по возможности используйте стандартный формат из «Примера запроса» на этой странице: для текста и reference materials используйте массив content, а для настроек генерации — верхнеуровневые поля duration, ratio, resolution, fps и т. д.

• mode：t2v / i2v / i2v_first_last / reference_images / reference_material
• image_url / image_urls / input_reference
• end_image_url / last_image_url
• video_urls / audio_urls
• seconds / duration
• aspect_ratio / ratio / size
• quality / resolution
• fps
• generate_audio / watermark

Детали вызова:

• При использовании mode=reference_material или function_mode=omni_reference рекомендуется передавать текст и референсные материалы через content.
• content: текстовый элемент задаётся в формате { "type": "text", "text": "测试文字" }.
• content: элементы изображений, видео и аудио оформляются соответственно с помощью объектов image_url, video_url и audio_url, например { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
• role может обозначать назначение материала, name можно ссылаться по имени в подсказке.
• ratio, duration, resolution и fps влияют на итоговую конфигурацию генерации.

Seedance 2.5 Пример смешанной ссылки на изображения, видео и аудио (URL материалов являются заполнителями; при вызове замените их фактически доступными ссылками):

{
  "model": "sd-2-5",
  "ratio": "9:16",
  "fps": 24,
  "duration": 10,
  "content": [
    {
      "type": "text",
      "text": "使用 @图片1 @图片2 @图片3 @音频1 参考@视频1 生成视频"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo1.png"
      },
      "role": "reference_image",
      "name": "图片1"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo2.png"
      },
      "role": "reference_image",
      "name": "图片2"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo3.png"
      },
      "role": "reference_image",
      "name": "图片3"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://video.mp4"
      },
      "role": "reference_video",
      "name": "视频1"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://audio.mp3"
      },
      "role": "reference_audio",
      "name": "音频1"
    }
  ]
}

Вызов Gemini Omni:

• gemini-omni также можно вызывать через этот интерфейс задачи Seedance.
• mode=t2v используется для генерации видео по тексту, mode=r2v — для генерации по референсным изображениям/материалам, mode=edit — для редактирования видео.
• Текст можно размещать в элементе text в prompt или content; изображения можно размещать в image_url / image_urls / reference_images / input_reference / content; видео — в video_urls / content.
• Для поля длительности можно использовать duration или seconds — будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.

Вызов MiniMax / Hailuo:

• minimax-h3 можно вызвать через этот интерфейс задачи; поддерживаются генерация видео по тексту, референс по изображению и референс по аудио; текст можно указать в текстовых полях prompt или content, а материалы — в полях content, image_urls, audio_urls и т. д.
• hailuo-2.3 можно вызвать через этот интерфейс задачи; требуется изображение первого кадра, рекомендуется передавать в content элемент image_url из role=first_frame.
• minimax-h3 обычно используют duration=5~15 и resolution=1440p; hailuo-2.3 обычно используют duration=6 или 10 и resolution=768p.

Ключевые поля в результатах запроса:

• items[].status
• items[].content.video_url или items[].video_url
• items[].error
• items[].progress

Error fields: error.code, error.message.

{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}

Kling 4.0

Вызовы Kling 4.0: kling-4.0 (720p) и kling-4.0-1080p одновременно поддерживают формат Seedance content/duration/resolution/ratio/mode, contents/settings/options и видеоформат OpenAI; тело запроса можно повторно использовать для обоих унифицированных видеовходов. Разрешение должно соответствовать имени модели. В Kling 4.0 можно напрямую использовать поля content/duration/resolution/ratio/mode формата Seedance или prompt/seconds/size/input_reference видеоформата OpenAI; для обоих вариантов не требуются дополнительные contents/settings/options. Устаревшая обёртка contents/settings/options поддерживается только для совместимости. Для mode доступны значения: t2v (только текст), i2v (один начальный кадр), i2v_first_last (два кадра: начальный и конечный), reference_images (обычные эталонные изображения), reference_material (изображение или видео в качестве эталона). Если mode не указан и нет явно заданного инструмента, при наличии эталонных материалов по умолчанию используется reference_material, а при их отсутствии — t2v. В режиме reference используются роли обычных эталонных изображений; явно заданные начальный и конечный кадры не преобразуются неявно в эталонные изображения. Для начального и конечного кадров явно выберите i2v или i2v_first_last и не указывайте параметр соотношения сторон. Эталонный звук сейчас не поддерживается. settings.audio доступен только в универсальном режиме для эталонных изображений/материалов; для t2v, i2v и i2v_first_last не указывайте переключатель звука.

Vidu Q4

Vidu Q4: для vidu-q4 фиксированное разрешение 720p, для vidu-q4-540p — 540p; поддерживается генерация видео длительностью от 3 до 16 секунд. Требуется как минимум 1 изображение, поддерживается до 15 референсных изображений; к референсной генерации можно приложить до 3 аудиофайлов MP3, каждый длительностью от 3 до 12 секунд и размером до 50 МБ. Генерация только по тексту, указание начального и конечного кадров и референсное видео не поддерживаются. Несколько изображений используются как общие референсы и не обозначают позиции начала и конца. Задачи можно создавать через POST /v1/videos, POST /api/v3/contents/generations/tasks или в формате Vidu с помощью POST /ent/v2/img2video, POST /ent/v2/reference2video. Для унифицированной точки входа рекомендуется использовать mode=reference_images; при наличии аудио используйте mode=reference_material. Для референсного аудио можно использовать audio_urls; в формате Seedance также можно использовать параметр audio_url стандартного content. Булево поле audio обозначает переключатель генерации аудио и используется отдельно от списка URL референсного аудио. Разрешение должно соответствовать имени модели.