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

# Create Scene and Audio Description

> Generate a narrated description of what happens on screen.

Audio description makes a video usable without sight: the action between the dialogue is described aloud. Point this at a run that already has a transcript. Name the voice to narrate with — either a `speaker_id` from the run or a `voice_id` from your library — or omit both and let the pipeline choose.

Track progress by polling [`/scene-audio-description/{task_id}`](get-scene-audio-description-status) with the `task_id` returned in the response.


## OpenAPI

````yaml post /scene-audio-description
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /scene-audio-description:
    post:
      tags:
        - Scene And Audio Description
      summary: Create Scene Audio Description
      operationId: create_scene_audio_description_scene_audio_description_post
      parameters:
        - name: traceparent
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Traceparent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSceneAudioDescriptionRequestPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrchestratorPipelineCallResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    CreateSceneAudioDescriptionRequestPayload:
      properties:
        run_id:
          type: integer
          exclusiveMinimum: 0
          title: Run Id
          description: The run to describe. Must already have a transcript.
        revision_num:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
            - type: 'null'
          title: Revision Num
          description: Revision to describe. Defaults to the run's latest revision.
        speaker_id:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
            - type: 'null'
          title: Speaker Id
          description: Speaker whose voice narrates. Omit both to let the pipeline choose.
        voice_id:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
            - type: 'null'
          title: Voice Id
          description: Voice that narrates the description.
      type: object
      required:
        - run_id
      title: CreateSceneAudioDescriptionRequestPayload
    OrchestratorPipelineCallResult:
      properties:
        task_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Task Id
      type: object
      required:
        - task_id
      title: OrchestratorPipelineCallResult
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````

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