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

# Generate video with Kling V3 Omni

> Kuaishou Kling V3 Omni — text-to-video; image-to-video (start + optional end frame); reference-images-to-video (up to 7 images); and video-to-video editing (supply a `video`). 720p / 1080p / 4K, priced per resolution and per audio (see `resolution_pricing` in GET /v1/models and POST /v1/cost). Video-edit carries its own per-second rate and never has audio (the model forces sound off with an input video).

**Asynchronous.** Returns a job `id` (the video is not in this response). Poll [`GET /v1/videos/{id}`](/api-reference/videos/get-video-job-status) until `status` is `succeeded` — the video URL is in that response's `video_url`.



## OpenAPI

````yaml /openapi.yaml post /videos/kling-v3-omni-video
openapi: 3.1.0
info:
  contact:
    email: support@budgetpixel.com
    name: BudgetPixel Support
  description: >
    The BudgetPixel developer API for programmatic image and video generation.


    Generation is **asynchronous**: you create a job, then poll its status until
    it

    reaches a terminal state (`succeeded` / `failed`). You are charged in
    credits

    only on success — never for failures, timeouts, or content blocked before

    generation.


    **Authentication.** All requests require an API key sent as a bearer token:

        Authorization: Bearer bpx_live_xxx

    Create and manage keys from your BudgetPixel account dashboard. The
    developer

    API is currently available on the **Ultra** plan.


    **Pricing.** API usage is metered in credits at each model's published price

    (see `GET /v1/models`). Consumer subscription perks (free daily generations,

    free-for-Ultra models, subscription discounts) do not apply to API traffic.
  title: BudgetPixel API
  version: '2026-06-20'
servers:
  - description: Production
    url: https://api.budgetpixel.com/v1
security:
  - ApiKeyAuth: []
tags:
  - description: Account and credit balance
    name: Account
  - description: Discover available models and pricing
    name: Models
  - description: Upload input media for image/video generation
    name: Uploads
  - description: Image job status
    name: Images
  - description: FLUX image models
    name: Black Forest Labs
  - description: SeeDream image models
    name: Bytedance
  - description: Video job status
    name: Videos
  - description: Kuaishou Kling video models
    name: Kling
  - description: SeeDance video models
    name: ByteDance (SeeDance)
  - description: Music job status
    name: Audios
  - description: Music generation models
    name: Music
  - description: Format conversion for images, video, and audio
    name: Conversions
  - description: Publish posts to your BudgetPixel feed
    name: Social
  - description: Content moderation — NSFW rating and CSAM detection
    name: Moderation
  - description: Content classification — music genre detection
    name: Classification
paths:
  /videos/kling-v3-omni-video:
    post:
      tags:
        - Kling
      summary: Generate video with Kling V3 Omni
      description: >-
        Kuaishou Kling V3 Omni — text-to-video; image-to-video (start + optional
        end frame); reference-images-to-video (up to 7 images); and
        video-to-video editing (supply a `video`). 720p / 1080p / 4K, priced per
        resolution and per audio (see `resolution_pricing` in GET /v1/models and
        POST /v1/cost). Video-edit carries its own per-second rate and never has
        audio (the model forces sound off with an input video).


        **Asynchronous.** Returns a job `id` (the video is not in this
        response). Poll [`GET
        /v1/videos/{id}`](/api-reference/videos/get-video-job-status) until
        `status` is `succeeded` — the video URL is in that response's
        `video_url`.
      operationId: createVideo_kling_v3_omni_video
      requestBody:
        content:
          application/json:
            schema:
              properties:
                aspect_ratio:
                  default: '16:9'
                  description: >-
                    Aspect ratio. Ignored when an input image or video already
                    sets the frame.
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                  type: string
                end_image:
                  description: >-
                    Optional end frame, used together with `image` (the start
                    frame) to interpolate the video between the two frames. Same
                    input forms as `image`.
                  type: string
                generate_audio:
                  description: >-
                    Generate audio with the video. Raises the 720p/1080p
                    per-second rate (no price impact at 4K); unavailable on
                    video-edit.
                  type: boolean
                image:
                  description: >-
                    Optional start frame for image-to-video. Provide a public
                    image URL, a data URI, raw base64, or an uploaded-file URL
                    from POST /v1/uploads. Omit for text-to-video. Can't be
                    combined with `reference_images`.
                  type: string
                length_seconds:
                  default: 5
                  description: >-
                    Video length in seconds (3–15). For video-edit, set this to
                    the input video's rounded duration.
                  maximum: 15
                  minimum: 3
                  type: integer
                prompt:
                  description: Text description of the video.
                  type: string
                reference_images:
                  description: >-
                    Optional reference images that guide the generated video.
                    Each item is a public image URL, a data URI, raw base64, or
                    an uploaded-file URL from POST /v1/uploads. Can't be
                    combined with `image`/`end_image` (start/end frames). Up to
                    7 on their own (reference-images-to-video); up to 4 when
                    accompanying a `video` edit.
                  items:
                    type: string
                  maxItems: 7
                  type: array
                resolution:
                  default: 720p
                  description: >-
                    Output resolution. Pricing varies by resolution — see
                    `resolution_pricing` in GET /v1/models.
                  enum:
                    - 720p
                    - 1080p
                    - 4k
                  type: string
                video:
                  description: >-
                    Optional input video for video-to-video editing. Provide a
                    public video URL or an uploaded-file URL from POST
                    /v1/uploads (videos are passed by URL, not inlined). When
                    set, the request runs in video-edit mode: up to 4
                    `reference_images` may guide the edit, start/end frames are
                    not supported, audio is always off, and the output length
                    matches the input video — set `length_seconds` to the
                    input's duration rounded to whole seconds (3–15), which is
                    what billing uses.
                  type: string
              required:
                - prompt
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateVideoResponse'
          description: Job accepted.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    CreateVideoResponse:
      properties:
        id:
          description: Opaque job id — use it to poll status.
          type: string
        message:
          type: string
        model:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
      type: object
    JobStatus:
      description: Lifecycle state. `succeeded`/`failed`/`timeout` are terminal.
      enum:
        - pending
        - starting
        - processing
        - completing
        - succeeded
        - failed
        - timeout
      type: string
    Error:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable code.
              example: model_not_available
              type: string
            message:
              type: string
            type:
              description: Error category.
              example: invalid_request_error
              type: string
          required:
            - type
            - code
            - message
          type: object
      required:
        - error
      type: object
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: The request was malformed or referenced an unavailable model.
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Missing or invalid API key.
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Authenticated but not permitted (plan gate, ownership, restriction).
    TooManyRequests:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Rate or queue limit reached. Retry after a short delay.
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: bpx_live_*
      description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx'
      scheme: bearer
      type: http

````