Создать видео
Интерфейс генерации видео в совместимом формате OpenAI Sora. Поддерживает режимы генерации видео по тексту и по референсу изображения/видео.
POST /v1/videos: Создание задачи генерации видеоGET /v1/videos/{video_id}: Запрос статуса задачиGET /v1/videos/{video_id}/content: получить двоичное содержимое видео
В настоящее время недоступно внешним пользователям:
GET /v1/videosPOST /v1/videos/{video_id}/remix
Стандартные заголовки аутентификации:
Content-Type: application/json
- Создайте задачу через
POST /v1/videosи получитеid - Выполняйте опрос
GET /v1/videos/{id}, пока не получитеcompletedилиfailed - После завершения в первую очередь используйте
video_urlиз ответа - Если требуется унифицированная загрузка, вызовите
GET /v1/videos/{id}/content
Основные параметры:
model: string: обязательно, внешнее имя моделиprompt: string: рекомендуется, описание для генерации видеоseconds: number|string: необязательно, целевая длительностьduration: number|string: необязательно, псевдоним длительностиsize: string: необязательно, размер выходного видеоmode: string: необязательно, распространённые значения:t2vi2vi2v_first_lastreference_material
Часто используемые совместимые параметры:
aspect_ratioratioqualityresolutionfpsimageimage_urlimage_urlsimagesreference_imagesinput_referenceend_image_urllast_image_urlvideo_urlsaudio_urlsfunction_modecontentcallback_urlexternal_task_id
Распространённые расширенные параметры Kling:
model_namenegative_promptcfg_scalesoundcamera_controlimage_listvideo_idtask_idwatermark_info
4.1 Серия Veo
Примечание: stable, official и т. п. обозначают разные группы, а не внешний суффикс model; при вызове сохраняйте model как базовое имя модели, а то, через какую группу пойдёт запрос, определяется группой аккаунта или токена.
Основная модель Veo 3.x
veo3veo3-fastveo3-fast-framesveo3-framesveo3-proveo3-pro-framesveo3.1veo3.1-fastveo3.1-proveo3.1-componentsveo3.1-4kveo3.1-pro-4k
Рекомендации:
- Для генерации видео только по тексту в первую очередь используйте основные модели
veo3*/veo3.1* - Для сценариев генерации видео по изображению или по референсу рекомендуется явно передавать
mode + image_url/reference_images
4.2 Серия Sora
Базовые модели:
sora-2sora-2-pro
Рекомендации:
sora-2*подходит для общего использования- Если нужно использовать группы
stable/officialи т. п., сохраняйтеmodelкак базовое имя модели и не добавляйте суффикс к имени модели.
4.3 Серия Seedance
Публичная модель:
doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-lite-i2v-250428doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-5-pro-251215doubao-seedance-2-0-260128doubao-seedance-2-0-fast-260128
Рекомендации:
- Для генерации видео по тексту в приоритете
*-t2v-*илиpro / fast - Для генерации видео по изображению в приоритете
*-i2v-* - Для сценариев со сложными референсными материалами предпочтительно использовать
content
4.4 Серия видео Grok
Публичная модель:
grok-imagine-1.0-videogrok-imagine-video-1.5-previewgrok-video-3
Часто используемые параметры:
promptratio/aspect_ratioresolution/sizeseconds/durationimage/image_url/input_referencereference_images
Пример:
{
"model": "grok-imagine-1.0-video",
"prompt": "雨夜霓虹街道上的电影感推镜,光影丰富,运动自然",
"reference_images": [
"https://example.com/ref-1.jpg"
],
"seconds": 10,
"aspect_ratio": "16:9",
"resolution": "720P"
}
4.5 Основная видеомодель Kling
Основная публичная модель:
kling-video
Обязательно:
modelmodel_name
Поддерживаемые model_name:
kling-v1kling-v1-5kling-v1-6kling-v2-masterkling-v2-1kling-v2-1-masterkling-v2-5-turbokling-v2-6kling-v3
Распространённые mode:
t2vi2vmulti_i2vextend
Минимальные входные параметры:
- Генерация видео по тексту:
model + model_name + prompt + mode=t2v - Генерация видео по изображению:
model + model_name + prompt + mode=i2v + image - Референс по нескольким изображениям:
model + model_name + prompt + mode=multi_i2v + image_list - Продление видео:
model + model_name + mode=extend + video_id
Пример:
{
"model": "kling-video",
"model_name": "kling-v2-6",
"mode": "t2v",
"prompt": "海边日落镜头,电影感,风吹长发",
"duration": 5,
"aspect_ratio": "16:9"
}
-
mode=t2v -
Минимальное количество входных параметров:
model + prompt -
mode=i2v -
Минимальное количество входных параметров:
model + prompt + image_url -
mode=i2v_first_last -
Минимальное количество входных параметров:
model + prompt + image_url + end_image_url -
mode=reference_images -
Минимальное количество входных параметров:
model + prompt + reference_images -
mode=reference_material -
Минимальное количество входных параметров:
model + prompt + (image_urls/video_urls/audio_urls 至少一种)
Инструкция по вызову Gemini Omni
gemini-omni— публичное имя видеомодели в new-api, можно напрямую вызывать черезPOST /v1/videos.mode=t2v: генерация видео по тексту, минимальный входной параметр —model + prompt.mode=r2v: генерация по референсному изображению/материалу, изображение можно указать вimage,image_url,images,image_urls,reference_images,input_referenceилиcontent.mode=edit: редактирование видео, видео можно указать вvideo,video_url,videosилиcontent, также можно одновременно передать референсное изображение.- Для поля длительности можно использовать
secondsилиduration— будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.
Авторизации
Используйте проверку подлинности Bearer Token.
Формат: Authorization: Bearer sk-xxxxxx
Тело
Обязательно, внешнее имя модели. gemini-omni Можно вызывать через /v1/videos.
sora-2, sora-2-pro, gemini-omni, happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, doubao-seedance-1-0-lite-i2v-250428, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, veo3, veo3-fast, veo3-fast-frames, veo3-frames, veo3-pro, veo3-pro-frames, veo3.1, veo3.1-4k, veo3.1-components, veo3.1-fast, veo3.1-pro, veo3.1-pro-4k, kling-video, grok-imagine-1.0-video, grok-imagine-video-1.5-preview, grok-video-3, viduq3-turbo, hailuo-video "sora-2"
Единая точка входа для промптов. Обязательно для большинства моделей.
Вход для одного изображения; в некоторых режимах совместимости сопоставляется с images.
Унифицированный параметр для длительности; некоторые модели также принимают seconds.
Video width
512
Video height
512
Video frame rate
30
Random seed
20231234
Number of videos to generate
1
Response format
"url"
User identifier
"user-1234"
Контейнер динамически расширяемых полей. Здесь десериализуется большое количество специфичных для модели полей.
Необязательно, режим генерации видео. gemini-omni Поддерживает t2v、r2v、edit。
Единая точка входа для нескольких изображений. Используется в Vidu, Seedance, Veo и т. д.
Унифицированная точка входа для размера; будет сопоставляться с resolution/aspect_ratio и т. д.
Sora Совместимый входной параметр; во время выполнения будет выполняться откат к duration.
Совместимый входной параметр для эталонного изображения Sora/Veo, может быть multipart-файлом или совместимым объектом.
Ответ
Задача на создание видео успешно создана
Should use VideoStatus constants: VideoStatusQueued, VideoStatusInProgress, VideoStatusCompleted, VideoStatusFailed
queued, in_progress, completed, failed, video_url, url, completed_at Совместимо со старым интерфейсом; подлежит выводу из эксплуатации
