跳转到正文

使用故事板创建视频

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/videos:
    post:
      summary: 使用故事板创建视频
      deprecated: false
      description: ''
      tags:
        - 视频模型/sora 视频生成/OpenAI官方视频格式
      parameters: []
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                model:
                  example: sora-2
                  type: string
                prompt:
                  description: 提示词的格式固定为示例格式,可以更改时间和 Scene 描述
                  example: >-
                    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
                  type: string
                seconds:
                  type: string
                  enum:
                    - '10'
                    - '15'
                    - '25'
                  x-apifox-enum:
                    - value: '10'
                      name: ''
                      description: ''
                    - value: '15'
                      name: ''
                      description: ''
                    - value: '25'
                      name: ''
                      description: 仅 pro 支持
                  description: 生成视频时长
                  example: '15'
                input_reference:
                  format: binary
                  type: string
                  description: 参考图片
                  example: >-
                    file://C:\Users\WUKONG\Desktop\989e-633a9d8ce6ef59a78b06bfe2b487c896.jpg
                size:
                  description: >+
                    输出分辨率格式为宽度 x
                    高度(允许的值:720x1280,1280x720,1024x1792,1792x1024)。默认值为
                    720x1280。

                  example: 720x1280
                  type: string
                watermark:
                  description: 是否需要水印,不传默认无水印
                  example: 'false'
                  type: string
                private:
                  type: boolean
                  description: 是否隐藏视频,true-视频不会发布,同时视频无法进行 remix(二次编辑), 默认为 false
                  example: 'false'
                character_url:
                  type: string
                  description: 创建角色需要的视频链接,注意视频中一定不能出现真人,否则会失败
                  example: ''
                character_timestamps:
                  description: 视频角色出现的秒数范围,格式 {start},{end}, 注意 end-start 的范围 1~3秒
                  example: ''
                  type: string
                metadata:
                  example: ''
                  type: string
                character_from_task:
                  description: 已完成的任务 id,可以根据已经生成的任务 id,来创建角色
                  example: ''
                  type: string
                character_create:
                  type: boolean
                  description: 创建视频完成后,会自动根据生成的视频创建角色
                  example: ''
              required:
                - model
                - prompt
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                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
                x-apifox-orders:
                  - id
                  - object
                  - model
                  - status
                  - progress
                  - created_at
                  - seconds
                  - size
              example:
                id: sora-2:task_01kbhfs5yceakr1pa0qrfzfeqk
                object: video
                model: sora-2
                status: queued
                progress: 0
                created_at: 1764744797290
                seconds: '15'
                size: 1280x720
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: 视频模型/sora 视频生成/OpenAI官方视频格式
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7937429/apis/api-427877357-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://new.22codex.xyz
    description: 正式环境
security:
  - bearer: []

文档内容持续更新,请以控制台可用模型与接口为准。