青云TOP API开发文档开发者文档
控制台
返回模型调用 API 参考
POST/v1/videos

创建视频

API Key multipart/form-data

请求示例

curl -X POST https://top.qingyuntop.ai/v1/videos \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"

请求参数

参数位置类型必填说明示例
model请求体string是要使用的视频生成模型（允许的值：sora-2, sora-2-pro）。sora-2
prompt请求体string是描述要生成的视频的文本提示。A calico cat playing a piano on stage
seconds请求体string否剪辑时长（秒）（允许的值：4, 8, 12）。默认为 4 秒。4
size请求体string否输出分辨率格式为宽度 x 高度（允许的值：720x1280，1280x720，1024x1792，1792x1024）。默认值为 720x1280。 sora-2 支持 720x1280，1280x720 sora-2-pro 支持 1024x1792，1792x1024 720x1280
input_reference请求体file否可选的图像参考，用于指导生成。file://C:\Users\Administrator\Desktop\fuji-mountain-kawaguchiko-lake-morning-autumn-seasons-fuji-mountain-yamanachi-japan_副本.jpg
watermark请求体string否-ALL模型可用参数false
private请求体string否-ALL模型可用参数false
style请求体string否-ALL模型可用参数 风格只支持：thanksgiving, comic, news, selfie, nostalgic, animeanime

返回响应 (200)

此部分没有定义参数。

响应示例

{
    "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1761622232,
    "seconds": "10",
    "size": "1280x720"
}
来源原始接口定义（用于追溯）

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 497673339,
  "name": "创建视频",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "",
  "operationId": "",
  "sourceUrl": "",
  "method": "post",
  "path": "/v1/videos",
  "tags": [],
  "status": 1,
  "requestBody": {
    "type": "multipart/form-data",
    "parameters": [
      {
        "id": "JneOMkZTMb",
        "name": "model",
        "required": true,
        "enable": true,
        "description": "要使用的视频生成模型（允许的值：sora-2, sora-2-pro）。",
        "type": "string",
        "sampleValue": "sora-2"
      },
      {
        "id": "MspMEqG0Yi",
        "name": "prompt",
        "required": true,
        "enable": true,
        "description": "描述要生成的视频的文本提示。",
        "type": "string",
        "sampleValue": "A calico cat playing a piano on stage"
      },
      {
        "id": "QHFWKkJhjS",
        "name": "seconds",
        "required": false,
        "enable": true,
        "description": "剪辑时长（秒）（允许的值：4, 8, 12）。默认为 4 秒。",
        "type": "string",
        "sampleValue": "4"
      },
      {
        "id": "uUrbYSj8r2",
        "name": "size",
        "required": false,
        "enable": true,
        "description": "输出分辨率格式为宽度 x 高度（允许的值：720x1280，1280x720，1024x1792，1792x1024）。默认值为 720x1280。\nsora-2 支持 720x1280，1280x720\nsora-2-pro 支持 1024x1792，1792x1024\n\n",
        "type": "string",
        "sampleValue": "720x1280"
      },
      {
        "id": "CKLcYn3cMH",
        "name": "input_reference",
        "required": false,
        "enable": true,
        "description": "可选的图像参考，用于指导生成。",
        "type": "file",
        "schema": {
          "format": "binary",
          "type": "string"
        },
        "sampleValue": "file://C:\\Users\\Administrator\\Desktop\\fuji-mountain-kawaguchiko-lake-morning-autumn-seasons-fuji-mountain-yamanachi-japan_副本.jpg"
      },
      {
        "id": "NcLstbF7qV",
        "name": "watermark",
        "required": false,
        "enable": false,
        "description": "-ALL模型可用参数",
        "type": "string",
        "sampleValue": "false"
      },
      {
        "id": "gXnwADpexf",
        "name": "private",
        "required": false,
        "enable": false,
        "description": "-ALL模型可用参数",
        "type": "string",
        "sampleValue": "false"
      },
      {
        "id": "2L9S5j99a9",
        "name": "style",
        "required": false,
        "enable": false,
        "description": "-ALL模型可用参数 风格只支持：thanksgiving, comic, news, selfie, nostalgic, anime",
        "type": "string",
        "sampleValue": "anime"
      }
    ],
    "examples": [],
    "mediaType": "",
    "oasExtensions": "",
    "required": false,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [],
    "cookie": [],
    "header": []
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {},
  "responses": [
    {
      "id": 198983916,
      "name": "成功",
      "code": 200,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "",
      "mediaType": "",
      "headers": []
    }
  ],
  "responseExamples": [
    {
      "name": "成功示例",
      "responseId": 198983916,
      "data": "{\r\n    \"id\": \"video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980\",\r\n    \"object\": \"video\",\r\n    \"model\": \"sora-2\",\r\n    \"status\": \"queued\",\r\n    \"progress\": 0,\r\n    \"created_at\": 1761622232,\r\n    \"seconds\": \"10\",\r\n    \"size\": \"1280x720\"\r\n}",
      "description": "",
      "oasKey": "",
      "oasExtensions": "",
      "id": "019fd25e-4be6-7169-93b6-b99ddbe8574d"
    }
  ],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92436134,
  "ordering": 0,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {}
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-05T14:40:23.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}