交易平台

video-sora-2/image-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/image-to-video
input.first_frame_urlstring是视频首帧图片 URL，可为 URL 或 Base64
图片应为 720P、
input.promptstring否提示词，用于指导视频生成
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/image-to-video",
    "input": {
        "prompt": "将图片中的背景，更改为远古星空",
        "first_frame_url": "https://publicread.tiangangaitp.com/test/%E5%BE%85%E7%94%9F%E6%88%90%E5%8D%A1%E9%80%9A%E7%BE%8E%E5%A5%B3%20-720%2A1280.png"
    },
    "parameters": {
        "duration": 4
    }
}'
curl --request POST \
  --url https://api-ml.tiangangaitp.com/v1/video/generations \
  --header "Authorization: Bearer $API_KEY" \
  --data '{
    "model": "openai/sora-2/image-to-video",
    "input": {
        "prompt": "将图片中的背景，更改为远古星空",
        "first_frame_url": "https://publicread.tiangangaitp.com/test/%E5%BE%85%E7%94%9F%E6%88%90%E5%8D%A1%E9%80%9A%E7%BE%8E%E5%A5%B3%20-720%2A1280.png"
    },
    "parameters": {
        "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"
	}
}