跳转到主要内容
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⚠️ 要求：
  • 视频必须包含声音
  • 视频必须包含角色
💡 说明：
  • 参数 url 和 from_task 二选一，必须设置其中一个
示例："https://upload.apimart.ai/f/video/9998234807907072-ad4c2656-94a4-44d4-9eaa-5be2855a7798-video_task_01KBYT63R1TGZNT4EHAD495ZJ3.mp4"
​
from_task
string
已生成的视频任务 ID可以根据已经生成的任务 ID 来创建角色💡 说明：
  • 参数 url 和 from_task 二选一，必须设置其中一个
  • 使用此参数可以直接从之前生成的视频任务中提取角色
示例："task_01KBYT59JDHB4A3KDDR9N9JVWP"

​
Response

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