跳转到主要内容
POST
https://api.apimart.ai
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "url": "https://upload.apimart.ai/f/video/9998234807907072-ad4c2656-94a4-44d4-9eaa-5be2855a7798-video_task_01KBYT63R1TGZNT4EHAD495ZJ3.mp4",
    "timestamps": "1,3"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KBYT59JDHB4A3KDDR9N9JVWP"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "url": "https://upload.apimart.ai/f/video/9998234807907072-ad4c2656-94a4-44d4-9eaa-5be2855a7798-video_task_01KBYT63R1TGZNT4EHAD495ZJ3.mp4",
    "timestamps": "1,3"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KBYT59JDHB4A3KDDR9N9JVWP"
    }
  ]
}

Authorizations

Authorization
string
required
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY

Body

model
string
default:"sora-2"
required
视频生成模型名称支持的模型:
  • sora-2 - 标准版本
  • sora-2-pro - 专业版本
示例:"sora-2""sora-2-pro"
timestamps
string
required
角色出现的时间戳范围单位为秒,格式为 "起始秒,结束秒"⚠️ 限制:
  • 时间范围差值最小 1 秒
  • 时间范围差值最大 3 秒
示例:"1,3" 表示视频中第 1 秒到第 3 秒出现的角色
url
string
包含需要创建角色的视频 URL⚠️ 要求:
  • 视频必须包含声音
  • 视频必须包含角色
💡 说明:
  • 参数 urlfrom_task 二选一,必须设置其中一个
示例:"https://upload.apimart.ai/f/video/9998234807907072-ad4c2656-94a4-44d4-9eaa-5be2855a7798-video_task_01KBYT63R1TGZNT4EHAD495ZJ3.mp4"
from_task
string
已生成的视频任务 ID可以根据已经生成的任务 ID 来创建角色💡 说明:
  • 参数 urlfrom_task 二选一,必须设置其中一个
  • 使用此参数可以直接从之前生成的视频任务中提取角色
示例:"task_01KBYT59JDHB4A3KDDR9N9JVWP"

Response

code
integer
响应状态码,成功时为 200
data
array
返回数据数组