> ## Documentation Index
> Fetch the complete documentation index at: https://nusabase-a8dcf793.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Video Generation Task

> submit a video generation task (General format). Supports multiple Models (Kling, Hailuo, Sora, etc.), selectable via the model parameter. Supports text-to-video (prompt parameter) and image-to-video (image parameter). Returns a task ID that can be used to query task status with the GET endpoint.



## OpenAPI

````yaml /en/openapi/relay-api.mintlify.json post /v1/video/generations
openapi: 3.0.1
info:
  title: AI Relay API
  description: >-
    Unified AI Model API supporting OpenAI, Claude, Gemini, Kling, Jimeng and
    other formats
  version: 1.0.0
  license:
    name: Proprietary
    url: https://example.com/license
servers:
  - url: https://api.nusabasedigital.com
    description: API Base URL
security:
  - BearerAuth: []
tags:
  - name: Models
    description: Models endpoints
  - name: Chat
    description: Chat endpoints
  - name: Responses
    description: Responses endpoints
  - name: Realtime
    description: Realtime endpoints
  - name: Claude
    description: Claude endpoints
  - name: Gemini
    description: Gemini endpoints
  - name: Images
    description: Images endpoints
  - name: Video
    description: Video endpoints
  - name: Video / Kling
    description: Video / Kling endpoints
  - name: Video / Jimeng
    description: Video / Jimeng endpoints
  - name: Audio
    description: Audio endpoints
  - name: Embeddings
    description: Embeddings endpoints
  - name: Rerank
    description: Rerank endpoints
  - name: Moderations
    description: Moderations endpoints
  - name: Not Implemented
    description: Not Implemented endpoints
paths:
  /v1/video/generations:
    post:
      tags:
        - Video
      summary: Create Video Generation Task
      description: >-
        submit a video generation task (General format). Supports multiple
        Models (Kling, Hailuo, Sora, etc.), selectable via the model parameter.
        Supports text-to-video (prompt parameter) and image-to-video (image
        parameter). Returns a task ID that can be used to query task status with
        the GET endpoint.
      operationId: post_v1_video_generations
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoRequest'
        required: true
      responses:
        '200':
          description: Video generation task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoResponse'
          headers: {}
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    VideoRequest:
      type: object
      description: Video generation request
      properties:
        model:
          type: string
          description: Model/style ID
          example: kling-v1
        prompt:
          type: string
          description: Text promptPrompt
          example: An astronaut stands up and walks away
        image:
          type: string
          description: Image input (URL or Base64)
          example: https://example.com/image.jpg
        duration:
          type: number
          description: Video duration (seconds)
          example: 5
        width:
          type: integer
          description: Video width
          example: 1280
        height:
          type: integer
          description: Video height
          example: 720
        fps:
          type: integer
          description: Video frame rate
          example: 30
        seed:
          type: integer
          description: Random seed
          example: 20231234
        'n':
          type: integer
          description: Number of videos to generate
          example: 1
        response_format:
          type: string
          description: Response format
          example: url
        user:
          type: string
          description: User identifier
          example: user-1234
        metadata:
          type: object
          description: >-
            Additional parameters (such as negative_prompt, style,
            quality_level, etc.)
          additionalProperties: true
          properties: {}
    VideoResponse:
      type: object
      description: Video generation task submission response
      properties:
        task_id:
          type: string
          description: Task ID
          example: abcd1234efgh
        status:
          type: string
          description: Task status
          example: queued
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Error profile
            type:
              type: string
              description: Error type
            param:
              type: string
              description: Related parameter
              nullable: true
            code:
              type: string
              description: Error code
              nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.