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

# Create media generation job

> Submit a prompt to generate a character image, photo edit, or image-to-video clip.



## OpenAPI

````yaml api-reference/openapi.json post /generation/create
openapi: 3.1.0
info:
  version: 2.0.0
  title: Animus API
  description: >-
    Animus' API provides you with a variety of AI-driven capabilities. From
    generating text with our advanced large language models to creating
    customized content schedules, our API's applications are vast and versatile.

    Whether it's facilitating seamless conversation through predictive response
    or simulating a comprehensive content calendar, our advanced functionalities
    can cater to an array of feature requirements.
servers:
  - url: https://api.animusai.co/v2
security: []
paths:
  /generation/create:
    post:
      tags:
        - Generation
      summary: Create media generation job
      description: >-
        Submit a prompt to generate a character image, photo edit, or
        image-to-video clip.
      operationId: createGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerationRequest'
      responses:
        '200':
          description: Generation submission accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerationResponse'
        '400':
          description: The payload was invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Insufficient credits or subscription access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal error submitting the job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    GenerationRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          description: Primary prompt used for generation.
        negative_prompt:
          type: string
        strength:
          type: number
          format: float
          description: Blend weight for image-to-image edits (0-1).
        guidance_scale:
          type: number
          format: float
        num_inference_steps:
          type: integer
        seed:
          type: integer
          description: Fixed seed for reproducibility.
        width:
          type: integer
          description: Target width of the generated asset.
        height:
          type: integer
          description: Target height of the generated asset.
        num_images:
          type: integer
          minimum: 1
          description: Number of assets to generate. Values above 1 trigger batch mode.
        generation_type:
          type: string
          description: Optional manual override for the generation type.
        character_id:
          type: string
          description: Character identifier for LoRA-based renders.
        group_id:
          type: string
          description: Attach the result to an existing group.
        group_title:
          type: string
          description: Title to use when a new group is created.
        use_face_lora:
          type: boolean
        use_body_lora:
          type: boolean
        face_swap:
          type: boolean
        source_image_url:
          type: string
          format: uri
          description: Source image to edit or convert.
        convert_to_video:
          type: boolean
          description: Convert the result into a short MP4 clip.
    GenerationResponse:
      type: object
      properties:
        generation_id:
          type: string
        group_id:
          type: string
        status:
          type: string
          description: Submission status.
        message:
          type: string
        estimated_time:
          type: integer
          description: Estimated time to completion in seconds.
        credits_deducted:
          type: integer
        remaining_balance:
          type: integer
          description: Remaining credit balance for the organization.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Short error identifier.
        message:
          type: string
          description: Human readable error description.
        character_id:
          type: string
          description: Character that triggered the error, when relevant.
        group_id:
          type: string
          description: Group that triggered the error, when relevant.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````