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

# Get Music Generation

> One generation, including its `logs` timeline. This is the polling target while a generation is in flight: call it until `status` is `completed` or `failed`. Responses are never cached.



## OpenAPI

````yaml api-reference/openapi/content.json GET /api/music/{generationId}
openapi: 3.1.0
info:
  title: Recoup API - Content
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/music/{generationId}:
    get:
      summary: Get music generation
      description: >-
        One generation, including its `logs` timeline. This is the polling
        target while a generation is in flight: call it until `status` is
        `completed` or `failed`. Responses are never cached.
      parameters:
        - name: generationId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The generation's id, from [Generate
            Music](/api-reference/music/generate).
        - name: account_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Optional. Read on behalf of another account you can access.
      responses:
        '200':
          description: The generation, with its workflow timeline.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationDetailResponse'
        '400':
          description: '`generationId` is not a valid uuid.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '403':
          description: Access denied to this generation's account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '404':
          description: No generation with that id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    MusicGenerationDetailResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
          description: Status of the request
        generation:
          $ref: '#/components/schemas/MusicGenerationDetail'
    MusicGenerationErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - error
          description: Always `error`
        missing_fields:
          type: array
          description: >-
            JSON path segments to the first field that failed validation, e.g.
            `["lyrics"]`
          items:
            oneOf:
              - type: string
              - type: integer
        error:
          type: string
          description: Human-readable error message
    MusicGenerationDetail:
      allOf:
        - $ref: '#/components/schemas/MusicGeneration'
        - type: object
          properties:
            logs:
              type: array
              description: >-
                Ordered workflow timeline, oldest first. Returned only on the
                single-generation read.
              items:
                $ref: '#/components/schemas/MusicGenerationLogEntry'
    MusicGeneration:
      type: object
      description: One music generation.
      properties:
        id:
          type: string
          format: uuid
          description: >-
            The generation's id. Poll [Get Music
            Generation](/api-reference/music/get) with this.
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: >-
            Lifecycle phase. `pending` until the workflow picks it up,
            `processing` while fal is rendering, then `completed` or `failed`.
        prompt:
          type: string
          description: The music description the song was generated from.
        lyrics:
          type: string
          description: The lyrics the song was generated from.
        title:
          type: string
          nullable: true
          description: Display title. Null until the generation completes.
        model:
          type: string
          description: The generating model.
          example: minimax/music-3
        duration_seconds:
          type: number
          nullable: true
          description: >-
            Actual length of the generated audio. Null until completed; may be
            shorter than requested.
        seed:
          type: integer
          nullable: true
          description: >-
            Seed actually used. Null until completed. Pass it back to reproduce
            a generation.
        num_inference_steps:
          type: integer
          description: Flow-matching steps used.
        guidance_scale:
          type: number
          description: Guidance scale used.
        audio_url:
          type: string
          nullable: true
          description: Playable audio URL. Null until the generation completes.
        mime_type:
          type: string
          nullable: true
          description: Media type of the audio.
          example: audio/wav
        file_size_bytes:
          type: integer
          nullable: true
          description: Size of the generated audio in bytes.
        organization_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Organization the generation belongs to. Null for a personal
            generation.
        error_message:
          type: string
          nullable: true
          description: Why the generation failed. Null unless `status` is `failed`.
        created_at:
          type: string
          format: date-time
          description: When the generation was created.
        updated_at:
          type: string
          format: date-time
          description: When the generation last changed.
    MusicGenerationLogEntry:
      type: object
      description: One line of the generation's workflow timeline.
      properties:
        at:
          type: string
          format: date-time
          description: When the step ran.
        message:
          type: string
          description: What the step did.
          example: Queued, request id req_7f3a9c
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````