交易平台

video-异步任务模型 ​

Video generations ​

请求说明 ​

  • 基本信息

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

请求方式：POST

  • Header参数
名称类型必填描述
Content-TypeString是固定值application/json
AuthorizationString是"Bearer" + Apikey
  • Body参数
名称类型必填描述
modelstring是模型名称，当前支持： - Wan2.2-T2V-A14B：文本生成视频模型 - Wan2.2-I2V-A14B：图像生成视频模型
contentarray是内容列表，包含生成视频所需的提示词或图像信息
content[x].typestring是内容类型，支持： - text：文本提示词 - image_url：图像URL
content[x].textstring条件当type=text时必填，文本提示词，用于描述期望生成的视频内容
content[x].negative_promptstring否反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制。
content[x].image_url.urlstring条件type=image_url时必填，表示图片，支持以下格式： - Base64编码：例如：data:image/jpeg;base64,{BASE64_IMG} - 公网可访问的图片URL
content[x].rolestring条件图片的位置或用途。首帧图片对应的字段role为：first_frame，尾帧图片对应的字段role为：last_frame，支持Wan2.2-I2V-A14B
parameters.sizestring否视频分辨率，支持多种预设尺寸： - 480P：832*480, 480*832, 640*640 - 720P：1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P：1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632
parameters.durationnumber否视频时长（秒），支持：1～5
parameters.seedstring否种子值（整数字符串），用于控制生成内容的随机性。取值范围：[0, 2^32-1]之间的整数。默认随机生成一个值

响应说明 ​

  • 响应头参数
名称类型描述
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": "Wan2.2-T2V-A14B",
    "content": [
        {
            "type": "text",
            "text": "小猫在草地奔跑，有粒子效果"
        }
    ],
    "parameters": {
        "size": "640*640",
        "duration": 1,
        "seed": 8
    }
}'
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/video/generations \
  --header "Authorization: Bearer $API_KEY" \
  --data '{
    "model": "Wan2.2-T2V-A14B",
    "content": [
        {
            "type": "text",
            "text": "小猫在草地奔跑，有粒子效果"
        }
    ],
    "parameters": {
        "size": "640*640",
        "duration": 1,
        "seed": 8
    }
}'
  • 响应结果
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"
	}
}