火山方舟大模型服务平台

产品简介

快速入门-调用模型服务

快速入门-速览平台功能

模型介绍

模型列表

API 参考

获取 API Key 并配置

安装及升级 SDK

对话(Chat)-文本 API

POST

视频生成 API

图片生成 API

POST

向量化 API

创建视频生成任务 API开发中

POSThttps://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks

创建时间: 2025-05-31 21:08

请求参数

Header 参数

参数名	示例值	是否必填	参数类型	描述说明
Content-Type	application/json	是	string	-
Authorization	Bearer {{ARK_API_KEY}}	是	string	-

Body 参数application/json

数据结构

modelstring

必填

您创建的推理接入点（Endpoint）ID。该推理接入点需部署了视频生成的模型。 > 如无推理接入点，请参考[创建推理接入点](https://www.volcengine.com/docs/82379/1099522)文档创建。

contentarray<object>

必填

输入给模型，生成视频的信息，支持文本信息和图片信息。

typestring

可选

输入内容的类型，此处应为 text。

textstring

可选

输入给模型的文本内容，描述期望生成的视频，包括：文本提示词（必填）：支持中英文。参数（选填）：在文本提示词后追加--[parameters]，控制视频输出的规格，详情见模型文本命令(选填）。

resolutionstring

可选

视频分辨率，枚举值：

ratiostring

可选

不同模型默认值不同，一般是16:9wan2.1-14b-i2v，默认值： keep_ratiodoubao-seaweed 图生视频，默认值：adaptivedoubao-seedance-1-0-lite-i2v，默认值：adaptive生成视频的宽高比例，支持设置 480p 和 720p 两种分辨率下的宽高比。 16:9 4:3 1:1 3:4 9:16 21:9 9:21 keep_ratio：所生成视频的宽高比与所上传图片的宽高比保持一致。 adaptive：根据所上传图片的比例，自动选择最合适的宽高比。

durationinteger

可选

生成视频时长，单位：秒。枚举值：

framepersecondinteger

可选

帧率，即一秒时间内视频画面数量。枚举值：

watermarkboolean

可选

生成视频是否包含水印。枚举值：

seedinteger

可选

种子整数，用于控制生成内容的随机性。取值范围：[-1, 2^32-1]之间的整数。

camerafixedboolean

可选

是否固定摄像头。枚举值： true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。 false：不固定摄像头。

示例数据

{
  "model": "doubao-seedance-1-0-lite-t2v-250428",
  "content": [
    {
      "type": "text",
      "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠。 --ratio 16:9"
    }
  ]
}

响应示例

成功

HTTP状态码：200

内容格式：JSON

数据结构

idstring

可选

视频生成任务 ID 。创建视频生成任务为异步接口，获取 ID 后，需要通过查询视频生成任务 API 来查询视频生成任务的状态。任务成功后，会输出生成视频的video_url。

响应示例

{ "id": "pVjGKCmPhrvQaSaYgIpI" }

最后更新: 2 周前

POST对话(Chat)-文本 API

GET查询视频生成任务 API