> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neural4d.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 生成视频

> 通过文本提示词生成视频，并可选上传参考图。单次请求可上传 0 到 6 张参考图，并提交 1 到 4 个生成任务。



## OpenAPI

````yaml /openapi.old.zh.json post /api/createNormalVideo
openapi: 3.0.3
info:
  title: Neural4D 管理接口
  description: Neural4D 管理接口规范，中文界面下使用本规范展示中文接口说明。
  version: 1.5.4
servers:
  - url: https://alb.neural4d.com:3000
    description: 生产环境
security:
  - bearerAuth: []
tags:
  - name: text-to-3d
    description: 用于通过文本生成 3D 模型的接口。
    x-group: 文本生成 3D
  - name: image-to-3d
    description: 用于通过图片生成 3D 模型的接口。
    x-group: 图片生成 3D
  - name: model-management
    description: 用于查询模型、跟踪任务和转换格式的接口。
    x-group: 模型管理
  - name: media-generation
    description: 用于生成图片、视频以及查询结果的接口。
    x-group: 图片与视频生成
  - name: account-and-validation
    description: 用于校验输入图片和查询点数余额的接口。
    x-group: 账户与校验
paths:
  /api/createNormalVideo:
    post:
      tags:
        - media-generation
      summary: 生成视频
      description: 通过文本提示词生成视频，并可选上传参考图。单次请求可上传 0 到 6 张参考图，并提交 1 到 4 个生成任务。
      operationId: createNormalVideo
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateNormalVideoRequest'
            examples:
              default:
                value:
                  prompt: a flower bouquet
                  images:
                    - (binary)
                  duration: 14
                  aspectRatio: '9:16'
                  resolution: 480p
                  jobNum: 3
      responses:
        '200':
          description: 已接受视频生成任务
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueuedGenerationResponse'
              examples:
                queued:
                  value:
                    success: true
                    data:
                      pointsDeducted: 1344
                      queueStatus: queued
                      jobNum: 3
                      uuids:
                        - 18c8eb80-e1b0-43d4-878e-7fdd31a7e525
                        - 76f14626-e2ef-466c-a720-473dc64ebf43
                        - acb40a9d-082b-4842-bd92-1955b7eb1a13
components:
  schemas:
    CreateNormalVideoRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          description: 描述目标视频内容的文本提示词。
        images:
          type: array
          maxItems: 6
          items:
            type: string
            format: binary
          description: 用于引导生成的可选参考图。
        aspectRatio:
          type: string
          enum:
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
          default: '16:9'
          description: 生成视频的目标宽高比。
        jobNum:
          type: integer
          minimum: 1
          maximum: 4
          default: 1
          description: 提交的生成任务数量。
        duration:
          type: integer
          minimum: 4
          maximum: 15
          default: 5
          description: 目标视频时长，单位为秒。
        resolution:
          type: string
          enum:
            - 480p
            - 720p
            - 1080p
          default: 720p
          description: 目标输出分辨率。
    QueuedGenerationResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: 生成请求是否已被接受。
        data:
          $ref: '#/components/schemas/QueuedGenerationData'
          description: 已接受生成请求的队列和任务详情。
    QueuedGenerationData:
      type: object
      required:
        - pointsDeducted
        - queueStatus
        - jobNum
        - uuids
      properties:
        pointsDeducted:
          type: integer
          description: 当前已接受生成请求扣除的点数。
        queueStatus:
          type: string
          description: 已提交任务的当前排队状态。
        jobNum:
          type: integer
          description: 已接受的生成任务数量。
        uuids:
          type: array
          description: 分配给每个已接受生成任务的 UUID。
          items:
            type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 使用 Neural4D 网站提供的 Bearer token。
      x-default: YOUR_TOKEN

````