openapi: 3.0.0
servers:
  - url: https://prod.api.market/api/v1/magicapi/fast-text-to-video-api-with-audio
info:
  title: Ultra-Fast Text-to-Video API with Audio (Veo 3 Fast)
  description: Generate high-quality videos with synchronized audio from text
    prompts in secondscut costs and boost speed using Googles advanced Veo 3
    Fast technology.
  version: d7aca9396ea28c4ef46700a43cb59546c9948396eb571ca083df8344391335b3
components:
  schemas:
    Input:
      type: object
      title: Input
      required:
        - prompt
      properties:
        seed:
          type: integer
          title: Seed
          x-order: 3
          description: Random seed. Omit for random generations
          example: 1
        prompt:
          type: string
          title: Prompt
          x-order: 0
          description: Text prompt for video generation
          example: A hyper-speed superhero, resembling The Flash, is sprinting through a
            dense, dark forest at night. The trees blur into streaks of green
            and black as he moves. Fiery trails burst behind him with every
            stride, igniting parts of the underbrush in glowing embers. As he
            weaves between the trees, the blazing trail he leaves behind slowly
            forms the words 'VEO 3 FAST' in glowing, molten fire on the forest
            floor. The camera zooms up to show the entire text.
        enhance_prompt:
          type: boolean
          title: Enhance Prompt
          default: true
          x-order: 1
          description: Use Gemini to enhance your prompts
          example: true
        negative_prompt:
          type: string
          title: Negative Prompt
          x-order: 2
          nullable: true
          description: Description of what to discourage in the generated video
          example: A beautiful landscape with mountains
    Output:
      type: string
      title: Output
      format: uri
    Status:
      enum:
        - starting
        - processing
        - succeeded
        - canceled
        - failed
      type: string
      title: Status
      description: An enumeration.
    WebhookEvent:
      enum:
        - start
        - output
        - logs
        - completed
      type: string
      title: WebhookEvent
      description: An enumeration.
    ValidationError:
      type: object
      title: ValidationError
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
    PredictionRequest:
      type: object
      title: PredictionRequest
      properties:
        id:
          type: string
          title: Id
        input:
          $ref: "#/components/schemas/Input"
        context:
          type: object
          title: Context
          additionalProperties:
            type: string
        webhook:
          type: string
          title: Webhook
          format: uri
          maxLength: 65536
          minLength: 1
        created_at:
          type: string
          title: Created At
          format: date-time
        output_file_prefix:
          type: string
          title: Output File Prefix
        webhook_events_filter:
          type: array
          items:
            $ref: "#/components/schemas/WebhookEvent"
          default:
            - start
            - output
            - logs
            - completed
    PredictionResponse:
      type: object
      title: PredictionResponse
      properties:
        id:
          type: string
          title: Id
        logs:
          type: string
          title: Logs
          default: ""
        error:
          type: string
          title: Error
        input:
          $ref: "#/components/schemas/Input"
        output:
          $ref: "#/components/schemas/Output"
        status:
          $ref: "#/components/schemas/Status"
        metrics:
          type: object
          title: Metrics
        version:
          type: string
          title: Version
        created_at:
          type: string
          title: Created At
          format: date-time
        started_at:
          type: string
          title: Started At
          format: date-time
        completed_at:
          type: string
          title: Completed At
          format: date-time
    HTTPValidationError:
      type: object
      title: HTTPValidationError
      properties:
        detail:
          type: array
          items:
            $ref: "#/components/schemas/ValidationError"
          title: Detail
  securitySchemes: {}
security: {}
paths:
  /predictions:
    post:
      summary: Create a prediction with google/veo-3-fast
      description: Run inference with the google/veo-3-fast model on API.market
      operationId: createVeo_3_fastPrediction
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - version
                - input
              properties:
                version:
                  type: string
                  description: Model version ID
                  default: d7aca9396ea28c4ef46700a43cb59546c9948396eb571ca083df8344391335b3
                input:
                  $ref: "#/components/schemas/Input"
            examples:
              default:
                summary: Default example
                value:
                  version: d7aca9396ea28c4ef46700a43cb59546c9948396eb571ca083df8344391335b3
                  input:
                    prompt: A hyper-speed superhero, resembling The Flash, is sprinting through a
                      dense, dark forest at night. The trees blur into streaks
                      of green and black as he moves. Fiery trails burst behind
                      him with every stride, igniting parts of the underbrush in
                      glowing embers. As he weaves between the trees, the
                      blazing trail he leaves behind slowly forms the words 'VEO
                      3 FAST' in glowing, molten fire on the forest floor. The
                      camera zooms up to show the entire text.
                    enhance_prompt: true
      responses:
        "201":
          description: Prediction created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Unique identifier for the prediction
                  version:
                    type: string
                    description: Model version used for the prediction
                  status:
                    type: string
                    enum:
                      - starting
                      - processing
                      - succeeded
                      - failed
                      - canceled
                    description: Current status of the prediction
                  created_at:
                    type: string
                    format: date-time
                    description: When the prediction was created
              examples:
                success:
                  summary: Successful prediction creation
                  value:
                    id: ufawqhfynnddngldkgtslldrkq
                    version: d7aca9396ea28c4ef46700a43cb59546c9948396eb571ca083df8344391335b3
                    status: starting
                    created_at: 2025-07-11T06:39:47.186Z
        "400":
          description: Bad request, validation error
        "401":
          description: Unauthorized, invalid API token
    parameters:
      - &a1
        description: API.market API Key
        in: header
        name: x-api-market-key
        value: Please Login/Signup to get an API Key
        required: true
        schema:
          type: string
  /predictions/{id}:
    get:
      summary: Get prediction status and results
      description: Get the status and results of a google/veo-3-fast prediction from
        API.market
      operationId: getVeo_3_fastPrediction
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The prediction ID
      responses:
        "200":
          description: Prediction details
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Unique identifier for the prediction
                  status:
                    type: string
                    enum:
                      - starting
                      - processing
                      - succeeded
                      - failed
                      - canceled
                    description: Current status of the prediction
                  output:
                    $ref: "#/components/schemas/Output"
                  error:
                    type: string
                    description: Error message if the prediction failed
                  created_at:
                    type: string
                    format: date-time
                    description: When the prediction was created
                  started_at:
                    type: string
                    format: date-time
                    description: When the prediction started processing
                  completed_at:
                    type: string
                    format: date-time
                    description: When the prediction completed
              examples:
                succeeded:
                  summary: Successful prediction result
                  value:
                    id: ufawqhfynnddngldkgtslldrkq
                    status: succeeded
                    output: https://blog.api.market/wp-content/uploads/2026/04/veo3-fast-api-market.mp4
                    created_at: 2023-01-01T12:00:00.000Z
                    started_at: 2023-01-01T12:00:05.000Z
                    completed_at: 2023-01-01T12:01:00.000Z
        "401":
          description: Unauthorized, invalid API token
        "404":
          description: Prediction not found
    parameters:
      - *a1
tags:
  - name: artificial-intelligence
    description: Operations related to artificial-intelligence
  - name: video
    description: Operations related to video
  - name: text-to-video
    description: Operations related to text-to-video