创建视频 (带 Character)

POST /v1/video/create

MethodPOST
Path/v1/video/create
Typehttp
Status-2
Module2102810
Folder67930391

概览

MethodPOST
Path/v1/video/create
Typehttp
Status-2
Module2102810
Folder67930391

参数

{
  "header": [
    {
      "name": "Content-Type",
      "required": true,
      "description": "",
      "id": "KI6enZdPSI",
      "type": "string",
      "enable": true,
      "sampleValue": "application/json"
    }
  ]
}

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "images": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "model": {
        "type": "string"
      },
      "orientation": {
        "type": "string",
        "enum": [
          "portrait",
          "landscape"
        ],
        "x-apifox-enum": [
          {
            "value": "portrait",
            "name": "",
            "description": "竖屏"
          },
          {
            "value": "landscape",
            "name": "",
            "description": "横屏"
          }
        ]
      },
      "prompt": {
        "type": "string"
      },
      "duration": {
        "type": "integer",
        "description": "时长",
        "enum": [
          10,
          15,
          25
        ],
        "x-apifox-enum": [
          {
            "value": 10,
            "name": "",
            "description": "sora-2,sora-2-pro 可用"
          },
          {
            "value": 15,
            "name": "",
            "description": "sora-2,sora-2-pro 可用"
          },
          {
            "value": 25,
            "name": "",
            "description": "sora-2-pro可用"
          }
        ]
      },
      "character_url": {
        "type": "string",
        "description": "创建角色需要的视频链接,注意视频中一定不能出现真人,否则会失败"
      },
      "character_timestamps": {
        "type": "string",
        "description": "视频角色出现的秒数范围,格式 `{start},{end}`, 注意 end-start 的范围 1-3秒"
      },
      "size": {
        "type": "string",
        "enum": [
          "large",
          "small"
        ],
        "x-apifox-enum": [
          {
            "value": "large",
            "name": "高清",
            "description": ""
          },
          {
            "value": "small",
            "name": "一般",
            "description": ""
          }
        ]
      }
    },
    "required": [
      "model",
      "prompt",
      "size"
    ],
    "x-apifox-orders": [
      "images",
      "model",
      "orientation",
      "prompt",
      "duration",
      "character_url",
      "character_timestamps",
      "size",
      "01K8ZASVCXKDRDADSJ1KHETZGN"
    ]
  },
  "required": false,
  "mediaType": "",
  "examples": [
    {
      "value": "{\n    \"images\": [],\n    \"model\": \"sora-2\",\n    \"orientation\": \"portrait\",\n    \"prompt\": \"make animate\",\n    \"duration\": 15,\n    \"character_url\": \"https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4\",\n    \"character_timestamps\": \"1,3\",\n    \"size\": \"large\"\n}",
      "mediaType": "application/json",
      "description": ""
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 802848694,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]

响应示例

[
  {
    "name": "成功示例",
    "responseId": 802848694,
    "data": "{\r\n    \"id\": \"sora-2:task_01k900ag82ecgbewj2xa3758z0\",\r\n    \"status\": \"pending\",\r\n    \"status_update_time\": 1762010677921\r\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 722703419
  }
]