BudgetPixel Audios API

openapi: 3.2.0
info:
  title: Budgetpixel Audios API
  version: '2026-06-20'
  contact:
    email: support@budgetpixel.com
    name: BudgetPixel Support
  description: 'Operations tagged Audios across 2 of this provider''s published API definitions: budgetpixel-openapi.yaml, budgetpixel-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- description: Production
  url: https://api.budgetpixel.com/v1
security:
- ApiKeyAuth: []
tags:
- description: Music and sound-effect job status
  name: Audios
paths:
  /audios/{job_id}:
    get:
      description: 'Poll until `status` is `succeeded`. The generated track (or sound effect) is

        returned as a short-lived signed `audio_url` (valid for several hours; re-call

        this endpoint for a fresh URL anytime — the underlying object is deleted 24h

        after generation). Serves every `POST /v1/audios/{model}` job — music and

        sound effects alike.'
      operationId: getAudio
      parameters:
      - description: The opaque job id returned by the create endpoint (e.g. `aud_...`).
        in: path
        name: job_id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioJob'
          description: Current job status. `audio_url` is populated once succeeded.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      summary: Get music job status
      tags:
      - Audios
    servers:
    - description: Production
      url: https://api.budgetpixel.com/v1
components:
  schemas:
    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
    AudioJob:
      properties:
        audio_url:
          description: The generated track or sound effect (signed URL, valid several hours); present once `status=succeeded`.
          format: uri
          type: string
        created_at:
          format: date-time
          type: string
        error:
          type: string
        id:
          example: aud_a1b2c3d4e5f6
          type: string
        model:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        video_url:
          description: Video-to-sound-effect jobs only — the input video with the generated effects mixed in (signed URL, valid several hours); present once `status=succeeded`.
          format: uri
          type: string
      type: object
    JobStatus:
      description: Lifecycle state. `succeeded`/`failed`/`timeout` are terminal.
      enum:
      - pending
      - starting
      - processing
      - completing
      - succeeded
      - failed
      - timeout
      type: string
    AudioJob_2:
      properties:
        audio_url:
          description: The generated track or sound effect (signed URL, valid at least 6 hours); present once `status=succeeded`, until `expired` is `true`.
          format: uri
          type: string
        completed_at:
          description: When the job finished. Present once `status` is `succeeded` or `failed` (absent on jobs from before this field was added, October 2026).
          format: date-time
          type: string
        created_at:
          description: When the job was submitted.
          format: date-time
          type: string
        error:
          type: string
        expired:
          description: Present once `status=succeeded`. `true` after `expires_at`; no URLs are returned then.
          type: boolean
        expires_at:
          description: Present once `status=succeeded`. When the outputs are deleted, 24 hours after `created_at`.
          format: date-time
          type: string
        id:
          example: aud_a1b2c3d4e5f6
          type: string
        model:
          type: string
        prompt:
          description: The prompt exactly as you submitted it; absent for lyrics-only songs.
          type: string
        started_at:
          description: When processing started, i.e. when the job left the queue. Absent on jobs from before this field was added (October 2026).
          format: date-time
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        video_url:
          description: Video-to-sound-effect jobs only — the input video with the generated effects mixed in (signed URL, valid at least 6 hours); present once `status=succeeded`, until `expired` is `true`.
          format: uri
          type: string
      type: object
  responses:
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: The requested job was not found.
    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, account restriction). Content-moderation blocks are 400, not 403.
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: bpx_live_*
      description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx'
      scheme: bearer
      type: http
x-refined-from:
- budgetpixel-openapi.yaml
- budgetpixel-openapi.yml