交易平台

veo-3.1 视频相关API ​

Video generations ​

请求说明 ​

  • 基本信息

请求地址：https://api-ml.tiangangaitp.com/v1/video/generations

请求方式：POST

  • Header参数
名称类型必填描述
Content-TypeString是固定值application/json
AuthorizationString是"Bearer" + Apikey
  • Body参数
参数类型是否必选描述
modelstring是模型名称，此处为 veo-3.1-generate-001或veo-3.1-fast-generate-001
input.promptstring是提示词，用于指导视频生成
input.negative_promptstring否反向提示词，用于限制不希望出现的内容
input.imageobject否用于指导视频生成的图片对象，如果请求包含last_frame对象，则image为首帧对象
input.image.bytesBase64Encodedstring否图片的字节 base64编码字符串。纯 base64 编码数据，不能包含 data:image/jpeg;base64, 这个前缀。
input.image.mimeTypestring否图片的 MIME 类型，只接受以下 MIME 类型： image/jpeg image/png image/webp
input.last_frameobject否用于指导视频生成的尾帧图片对象
input.last_frame.bytesBase64Encodedstring否图片的字节 base64编码字符串。纯 base64 编码数据，不能包含 data:image/jpeg;base64, 这个前缀。
input.last_frame.mimeTypestring否图片的 MIME 类型，只接受以下 MIME 类型： image/jpeg image/png image/webp
parameters.resolutionstring否所生成视频的分辨率。可接受的值为 720p（默认值）或 1080p。
parameters.durationint否视频生成时长（秒），支持4、6或 8。默认为 8。
parameters.aspect_ratioint否指定所生成视频的宽高比。接受的值如下： 16:9 9:16 默认值为 16:9。
parameters.generate_audiobool是必选参数，为视频生成音频。接受的值包括 true或 false。
parameters.person_generationstring否用于控制是否允许人物或人脸生成的安全设置。以下项之一： allow_adult（默认值）：仅允许生成成人 dont_allow：禁止在图片中包含人物/人脸。

响应说明 ​

  • 响应头参数
名称类型描述
taskIdstring任务id
taskStatusstring任务状态，包括SUCCEEDED
, FAILED
, CANCELED
, PENDING
, SUSPENDED
, RUNNING

请求示例 ​

示例如下，请将参数示例值替换为实际值。

  • 纯文本请求示例
powershell
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/video/generations \
  --header "Authorization: Bearer $API_KEY" \
  --data '{
    "model": "veo-3.1-generate-001",
    "input": {
        "prompt": "make it run",
        "image": {
            "bytesBase64Encoded": "xxxxx",
            "mimeType": "image/jpeg"
        },
        "last_frame": {
            "bytesBase64Encoded": "xxxxx",
            "mimeType": "image/jpeg"
        }
    },
    "parameters": {
        "duration": 6,
        "aspect_ratio": "16:9",
        "resolution": "1080p",
        "generate_audio": true
    }
}'
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/video/generations \
  --header "Authorization: Bearer $API_KEY" \
  --data '{
    "model": "veo-3.1-generate-001",
    "input": {
        "prompt": "make it run",
        "image": {
            "bytesBase64Encoded": "xxxxx",
            "mimeType": "image/jpeg"
        },
        "last_frame": {
            "bytesBase64Encoded": "xxxxx",
            "mimeType": "image/jpeg"
        }
    },
    "parameters": {
        "duration": 6,
        "aspect_ratio": "16:9",
        "resolution": "1080p",
        "generate_audio": true
    }
}'
  • 响应结果
powershell
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"taskId": "4n3buLFnFRF5CgRXOrg7PK",
		"taskStatus": "PENDING"
	}
}
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"taskId": "4n3buLFnFRF5CgRXOrg7PK",
		"taskStatus": "PENDING"
	}
}

getTaskResult ​

请求说明 ​

  • 基本信息

请求地址：https://api-ml.tiangangaitp.com/v1/tasks/{taskId}

请求方式：POST

  • Header参数
名称类型必填描述
Content-TypeString是固定值application/json
  • url 参数
名称类型必填描述
taskIdstring是taskId

响应说明 ​

  • 响应头参数
名称类型描述
taskIdstring任务id
taskStatusstring任务状态，包括SUCCEEDED
, FAILED
, CANCELED
, PENDING
, SUSPENDED
, RUNNING
urlstring文件地址

请求示例 ​

示例如下，请将参数示例值替换为实际值。

  • 纯文本请求示例
powershell
curl --request GET \
  --url https://api-ml.tiangangaitp.com/v1/tasks/{taskId}
curl --request GET \
  --url https://api-ml.tiangangaitp.com/v1/tasks/{taskId}
  • 响应结果
powershell
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"url": "http://publicread.tiangangaitp.com/model/image/xxx.png",
		"taskId": "4n3buLFnFRF5CgRXOrg7PK",
		"taskStatus": "SUCCEEDED"
	}
}
{
	"code": 100000,
	"msg": "SUCCESS",
	"data": {
		"url": "http://publicread.tiangangaitp.com/model/image/xxx.png",
		"taskId": "4n3buLFnFRF5CgRXOrg7PK",
		"taskStatus": "SUCCEEDED"
	}
}