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

# Enqueue generation

> Enqueues an async image or video generation job.



## OpenAPI

````yaml https://dev.hub.oxen.ai/api/_spec/oxen_hub_api.json post /api/ai/queue
openapi: 3.0.0
info:
  title: oxen
  version: 0.224.2
servers:
  - url: https://dev.hub.oxen.ai
    variables: {}
security: []
tags: []
paths:
  /api/ai/queue:
    post:
      tags: []
      summary: Enqueue generation
      description: Enqueues an async image or video generation job.
      operationId: OxenApiWeb.Controllers.QueueController.create
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueueCreateRequest'
        description: Queue request
        required: false
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueueCreateResponse'
          description: Generation enqueued
        '400':
          content:
            application/json:
              schema:
                type: object
          description: Invalid request
      callbacks: {}
components:
  schemas:
    QueueCreateRequest:
      description: Enqueue an async image or video generation job.
      properties:
        aspect_ratio:
          nullable: true
          type: string
        duration:
          nullable: true
          type: integer
        model:
          description: Model ID to use
          type: string
        num_generations:
          default: 1
          maximum: 4
          minimum: 1
          type: integer
        prompt:
          description: Text prompt for generation
          type: string
        seed:
          nullable: true
          type: integer
        target_directory:
          nullable: true
          type: string
        target_namespace:
          description: Namespace to store results. Defaults to current user.
          nullable: true
          type: string
        target_repo:
          nullable: true
          type: string
      required:
        - model
        - prompt
      title: QueueCreateRequest
      type: object
    QueueCreateResponse:
      properties:
        generations:
          items:
            properties:
              generation_id:
                format: uuid
                type: string
              status:
                enum:
                  - queued
                type: string
            required:
              - generation_id
              - status
            type: object
          type: array
      required:
        - generations
      title: QueueCreateResponse
      type: object

````