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

# Suno Lyrics Timeline

> Use DeerAPI to call the Suno Lyrics Timeline endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Suno Lyrics Timeline workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/music/suno/get-lyrics-timeline.openapi.json GET /suno/act/timing/{clip_id}
openapi: 3.1.0
info:
  title: 'Timing: Lyrics and Audio Timeline API'
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/act/timing/{clip_id}:
    get:
      summary: 'Timing: lyrics and audio timeline'
      operationId: timing_lyrics_timeline
      parameters:
        - name: clip_id
          in: path
          required: true
          description: ''
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - aligned_words
                  - waveform_data
                  - hoot_cer
                  - is_streamed
                properties:
                  aligned_words:
                    type: array
                    items:
                      type: object
                      required:
                        - word
                        - success
                        - start_s
                        - end_s
                        - p_align
                      properties:
                        word:
                          type: string
                        success:
                          type: boolean
                        start_s:
                          type:
                            - number
                            - integer
                        end_s:
                          type:
                            - number
                            - integer
                        p_align:
                          type: number
                  waveform_data:
                    type: array
                    items: {}
                  hoot_cer:
                    type: integer
                  is_streamed:
                    type: boolean
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````