使用故事板创建视频

POST /v1/videos

MethodPOST
Path/v1/videos
Typehttp
Status1
Module2102810
Folder68864887

概览

MethodPOST
Path/v1/videos
Typehttp
Status1
Module2102810
Folder68864887

请求体

{
  "type": "multipart/form-data",
  "parameters": [
    {
      "name": "model",
      "required": true,
      "description": "",
      "id": "JneOMkZTMb",
      "type": "string",
      "enable": true,
      "sampleValue": "sora-2"
    },
    {
      "name": "prompt",
      "required": true,
      "description": "提示词的格式固定为示例格式,可以更改时间和 Scene 描述",
      "id": "MspMEqG0Yi",
      "type": "string",
      "enable": true,
      "sampleValue": "Shot 1:\\nduration: 5sec\\nScene: The fridge door opens. A cute, chubby purple monster comes out of it.\\n\\nShot 2:\\nduration: 5sec\\nScene: the color of the monster to purple Shot 3:\\nduration: 5sec\\nScene: A second monster comes out right after"
    },
    {
      "name": "seconds",
      "required": false,
      "description": "生成视频时长",
      "id": "QHFWKkJhjS",
      "type": "string",
      "enable": true,
      "schema": {
        "type": "string",
        "enum": [
          "10",
          "15",
          "25"
        ],
        "x-apifox-enum": [
          {
            "value": "10",
            "name": "",
            "description": ""
          },
          {
            "value": "15",
            "name": "",
            "description": ""
          },
          {
            "value": "25",
            "name": "",
            "description": "仅 pro 支持"
          }
        ]
      },
      "sampleValue": "15"
    },
    {
      "name": "input_reference",
      "required": false,
      "description": "参考图片",
      "id": "CKLcYn3cMH",
      "type": "file",
      "enable": true,
      "schema": {
        "format": "binary",
        "type": "string"
      },
      "sampleValue": "file://C:\\Users\\WUKONG\\Desktop\\989e-633a9d8ce6ef59a78b06bfe2b487c896.jpg"
    },
    {
      "name": "size",
      "required": false,
      "description": "宽x高,会忽略具体数据 宽>高 为横屏,宽<高为竖屏",
      "id": "uUrbYSj8r2",
      "type": "string",
      "enable": true,
      "sampleValue": "16x9"
    },
    {
      "name": "watermark",
      "required": false,
      "description": "带-all 后缀模型可用。是否需要水印,不传默认无水印",
      "id": "NcLstbF7qV",
      "type": "string",
      "enable": false,
      "sampleValue": "false"
    },
    {
      "required": false,
      "description": "带-all 后缀模型可用。是否隐藏视频,true-视频不会发布,同时视频无法进行 remix(二次编辑), 默认为 false",
      "type": "boolean",
      "id": "gXnwADpexf",
      "enable": false,
      "name": "private",
      "schema": {
        "type": "boolean"
      },
      "sampleValue": "false"
    },
    {
      "required": false,
      "description": "带-all 后缀模型可用。创建角色需要的视频链接,注意视频中一定不能出现真人,否则会失败",
      "type": "string",
      "id": "YLD49O1RCm",
      "enable": false,
      "name": "character_url",
      "schema": {
        "type": "string"
      },
      "sampleValue": ""
    },
    {
      "required": false,
      "description": "视频角色出现的秒数范围,格式 {start},{end}, 注意 end-start 的范围 1~3秒",
      "type": "string",
      "id": "Dt4Y9yShaN",
      "enable": false,
      "name": "character_timestamps",
      "sampleValue": ""
    },
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "yXexRfoHzb",
      "enable": false,
      "name": "metadata",
      "sampleValue": ""
    },
    {
      "required": false,
      "description": "已完成的任务 id,可以根据已经生成的任务 id,来创建角色",
      "type": "string",
      "id": "KEVxdQBxzB",
      "enable": false,
      "name": "character_from_task",
      "sampleValue": ""
    },
    {
      "required": false,
      "description": "创建视频完成后,会自动根据生成的视频创建角色",
      "type": "boolean",
      "id": "ZIFkjT5mw3",
      "enable": false,
      "name": "character_create",
      "schema": {
        "type": "boolean"
      },
      "sampleValue": ""
    }
  ],
  "required": false,
  "mediaType": "",
  "examples": [],
  "oasExtensions": ""
}

响应

[
  {
    "id": 790805674,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "object": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "progress": {
          "type": "integer"
        },
        "created_at": {
          "type": "integer"
        },
        "seconds": {
          "type": "string"
        },
        "size": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "object",
        "model",
        "status",
        "progress",
        "created_at",
        "seconds",
        "size"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]

响应示例

[
  {
    "name": "成功示例",
    "responseId": 790805674,
    "data": "{\r\n    \"id\": \"sora-2:task_01kbhfs5yceakr1pa0qrfzfeqk\",\r\n    \"object\": \"video\",\r\n    \"model\": \"sora-2\",\r\n    \"status\": \"queued\",\r\n    \"progress\": 0,\r\n    \"created_at\": 1764744797290,\r\n    \"seconds\": \"15\",\r\n    \"size\": \"1280x720\"\r\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 721570018
  }
]