交易平台

video-sora-2/text-to-video ​

Video generations ​

请求说明 ​

  • 基本信息

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

请求方式：POST

  • Header参数
名称类型必填描述
Content-TypeString是固定值application/json
AuthorizationString是"Bearer" + Apikey
  • Body参数
参数类型是否必选描述
modelstring是模型名称，此处为 openai/sora-2/text-to-video
input.promptstring是提示词，用于指导视频生成
parameters.sizestring否生成视频的尺寸。 可选的分辨率： - 720x1280 - 1280x720 - 1024x1792 - 1792x1024 默认为 720x1280
parameters.durationint否视频生成时长（秒），可选值 4, 8, 12，默认为 4

响应说明 ​

  • 响应头参数
名称类型描述
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": "openai/sora-2/text-to-video",
    "input": {
        "prompt": "生成一个潇洒飘逸的剑仙人物"
    },
    "parameters": {
        "size": "720x1280",
        "duration": 4
    }
}'
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/video/generations \
  --header "Authorization: Bearer $API_KEY" \
  --data '{
    "model": "openai/sora-2/text-to-video",
    "input": {
        "prompt": "生成一个潇洒飘逸的剑仙人物"
    },
    "parameters": {
        "size": "720x1280",
        "duration": 4
    }
}'
  • 响应结果
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"
	}
}