Luma AI Video API

openapi: 3.1.0
info:
  title: Luma Dream Machine Concepts Video API
  description: 'REST API for Luma''s Dream Machine generative video and image platform.

    Submit a generation request, then poll for its status by ID. Resources

    include video generations (Ray models), image generations (Photon),

    upscale, modify (style transfer), reframe, audio attachment, credits,

    and concepts.

    Authentication uses Bearer tokens obtained from

    https://lumalabs.ai/dream-machine/api/keys.

    '
  version: '1.0'
  contact:
    name: Luma Labs
    url: https://docs.lumalabs.ai/
  license:
    name: Proprietary
    url: https://lumalabs.ai/legal/tos
servers:
- url: https://api.lumalabs.ai/dream-machine/v1
  description: Dream Machine API
security:
- BearerAuth: []
tags:
- name: Video
paths:
  /generations/video:
    post:
      tags:
      - Video
      summary: Create a video generation
      operationId: createVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                model:
                  type: string
                  description: Ray model variant
                aspect_ratio:
                  type: string
                loop:
                  type: boolean
                keyframes:
                  type: object
      responses:
        '201':
          description: Created generation
          content:
            application/json:
              schema:
                type: object
  /generations/video/modify:
    post:
      tags:
      - Video
      summary: Modify a video with style transfer
      operationId: modifyVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Modification job created
          content:
            application/json:
              schema:
                type: object
  /generations/video/reframe:
    post:
      tags:
      - Video
      summary: Reframe a video
      operationId: reframeVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Reframe job created
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key