使用故事板创建视频
POST /v1/videos
概览
| Method | POST |
|---|---|
| Path | /v1/videos |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 68864887 |
请求体
{ "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 } ]