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

# level audio

> Bring the cut to delivery level: every speaking clip to what platforms normalise to, so takes from different days, an upload and a generated voiceover sit together; music and effects move by the amount the speech moved. Nothing is raised into distortion: a clip whose peak would cross the ceiling stops there and is named. Written as ordinary clip volume, so preview and every export carry it. mode offset moves the whole cut by one amount and matches nothing, for a piece already balanced by hand. check_timeline reports whether it is needed and what is left after. Free, except measuring sound the first time: cloud processing.



## OpenAPI

````yaml /openapi.json post /tools/level_audio
openapi: 3.1.0
info:
  title: Eversince API
  version: '1'
  description: >-
    Every Eversince tool as one POST call, plus the routes beside them: the tool
    list, account and keys, uploads, webhooks and models. The prose is at
    https://docs.eversince.ai.
servers:
  - url: https://eversince.ai/api/v1
security:
  - bearer: []
tags:
  - name: Discovery
    description: The tool list, the same on the MCP server, the REST API and the CLI.
  - name: Workspace
    description: Jobs, balances, settings, templates, skills and the overview.
  - name: Library
    description: >-
      Items, search, import, reading media, comments, boards, calendars, the
      brand kit and public links.
  - name: Timeline
    description: 'Video editing: timelines, clips, captions, sound, language and rendering.'
  - name: Canvas
    description: 'Still editing: canvases, slides, layers and rendering.'
  - name: Generation
    description: Image, video and audio generation, upscaling, cutouts and models.
  - name: Research
    description: 'What platforms publish: pulling and keeping posts.'
  - name: Account
    description: Balances, keys, workspaces and script sessions.
  - name: Uploads
    description: Files into the library by presigned upload or by URL.
  - name: Webhooks
    description: Job results posted to a URL as they complete.
  - name: Models
    description: Generation models and cost estimates.
paths:
  /tools/level_audio:
    post:
      tags:
        - Timeline
      summary: level audio
      description: >-
        Bring the cut to delivery level: every speaking clip to what platforms
        normalise to, so takes from different days, an upload and a generated
        voiceover sit together; music and effects move by the amount the speech
        moved. Nothing is raised into distortion: a clip whose peak would cross
        the ceiling stops there and is named. Written as ordinary clip volume,
        so preview and every export carry it. mode offset moves the whole cut by
        one amount and matches nothing, for a piece already balanced by hand.
        check_timeline reports whether it is needed and what is left after.
        Free, except measuring sound the first time: cloud processing.
      operationId: level_audio
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/WorkspaceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                timeline_id:
                  type: string
                  description: The timeline id.
                mode:
                  description: >-
                    match (default) brings every speaking clip to the target, so
                    takes from different sources agree. offset moves the whole
                    cut by one amount and keeps the mix as it is, for a piece
                    already balanced by hand.
                  type: string
                  enum:
                    - match
                    - offset
                platform:
                  description: >-
                    Where it plays, which sets the target: youtube, instagram
                    and tiktok -14 LUFS, podcast -16, broadcast -23. Default
                    youtube.
                  type: string
                  enum:
                    - youtube
                    - instagram
                    - tiktok
                    - podcast
                    - broadcast
                target_lufs:
                  description: A target of its own, over platform.
                  type: number
                  minimum: -30
                  maximum: -6
                clip_ids:
                  description: >-
                    Write only these clips. The level is still worked out over
                    the whole cut, so one clip of an interview is matched to the
                    conversation rather than to itself.
                  type: array
                  items:
                    type: string
                if_revision:
                  description: >-
                    The revision get_timeline returned. A stale one fails with
                    revision_conflict instead of applying; so does no revision
                    once a user edited the timeline in the app since this
                    connection last read it.
                  anyOf:
                    - type: string
                    - type: integer
                context:
                  description: 'Optional: one sentence shown to the user beside this action.'
                  type: string
                  maxLength: 600
              required:
                - timeline_id
      responses:
        '200':
          description: >-
            Done, or a job started for work that runs longer (follow it with
            get_jobs).
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - data
                  - meta
                properties:
                  ok:
                    const: true
                  data:
                    type: object
                    additionalProperties: true
                  meta:
                    type: object
                    properties:
                      request_id:
                        type: string
                      cost:
                        $ref: '#/components/schemas/Cost'
                      cloud_processing:
                        $ref: '#/components/schemas/CloudProcessing'
                  media:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
      description: >-
        Retry a paid dispatch safely: the same key returns the job already
        dispatched instead of charging again.
    WorkspaceId:
      name: x-workspace-id
      in: header
      required: false
      schema:
        type: string
      description: The workspace this one call acts in, when it is not the key's own.
  schemas:
    Cost:
      type: object
      description: AI credits the call cost.
      additionalProperties: true
    CloudProcessing:
      type: object
      description: Cloud processing the call used, and what is left.
      properties:
        ran_on:
          const: cloud
        minutes:
          type: number
        queued_minutes:
          type: number
        left_minutes:
          type: number
        bought_minutes:
          type: number
        note:
          type: string
    Error:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: object
          required:
            - code
            - message
            - retryable
          properties:
            code:
              type: string
            message:
              type: string
              description: What went wrong, in words to act on.
            retryable:
              type: boolean
            suggested_action:
              type: string
              description: The next step that works.
            cloud_processing:
              $ref: '#/components/schemas/CloudProcessing'
  responses:
    Error:
      description: The call was refused or failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        An API key (es_live_…) from Settings, under API keys, or an OAuth access
        token.

````