Get aligned lyrics timeline

GET/api/v1/suno/clips/{clipId}/timelineCopy URL

Authentication · x-api-key

Word/line-level timestamps for a clip. Short sync-wait; returns 202 with taskId on timeout.

All endpointsRequestResponsesCode

Request

clipIdpath · Required

string

Suno clip identifier returned by a Generation or clip read.

Responses

200 OK

application/json

Unknown fields are not accepted.

• Response 200 · creditsChargedRequired

  number | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · creditsCharged · anyOf 1Alternative

    number

    Exact credits actually charged

    Minimum: 0.

  • Response 200 · creditsCharged · anyOf 2Alternative

    null

• Response 200 · creditsRequiredRequired

  number

  Exact credits deducted to start the task

  Minimum: 0.

• Response 200 · errorCodeRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · errorCode · anyOf 1Alternative

    string

    Error code if task failed

  • Response 200 · errorCode · anyOf 2Alternative

    null

• Response 200 · errorMessageRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · errorMessage · anyOf 1Alternative

    string

    Error message if task failed

  • Response 200 · errorMessage · anyOf 2Alternative

    null

• Response 200 · outputResultsRequired

  object | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · outputResults · anyOf 1Alternative

    object

    Unknown fields are not accepted.

    4 fields

    • Response 200 · outputResults · anyOf 1.clipIdRequired

      string

    • Response 200 · outputResults · anyOf 1.linesRequired

      array<object>
      1 field

      • Response 200 · outputResults · anyOf 1.lines[]Each item

        object

        Unknown fields are not accepted.

        5 fields

        • Response 200 · outputResults · anyOf 1.lines[].endRequired

          number

          Minimum: 0.

          1 field

          • Response 200 · outputResults · anyOf 1.lines[].endSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 200 · outputResults · anyOf 1.lines[].startRequired

          number

          Minimum: 0.

          1 field

          • Response 200 · outputResults · anyOf 1.lines[].startSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 200 · outputResults · anyOf 1.lines[].textRequired

          string
          1 field

          • Response 200 · outputResults · anyOf 1.lines[].textSee schema

            string

            Expand this value in the interactive reference.

        • Response 200 · outputResults · anyOf 1.lines[].wordsRequired

          array<object>
          1 field

          • Response 200 · outputResults · anyOf 1.lines[].wordsSee schema

            array<object>

            Expand this value in the interactive reference.

        • Response 200 · outputResults · anyOf 1.lines[].sectionOptional

          string
          1 field

          • Response 200 · outputResults · anyOf 1.lines[].sectionSee schema

            string

            Expand this value in the interactive reference.

    • Response 200 · outputResults · anyOf 1.waveform_dataRequired

      array<number>
      1 field

      • Response 200 · outputResults · anyOf 1.waveform_data[]Each item

        number

    • Response 200 · outputResults · anyOf 1.wordsRequired

      array<object>
      1 field

      • Response 200 · outputResults · anyOf 1.words[]Each item

        object

        Unknown fields are not accepted.

        5 fields

        • Response 200 · outputResults · anyOf 1.words[].endRequired

          number

          Minimum: 0.

          1 field

          • Response 200 · outputResults · anyOf 1.words[].endSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 200 · outputResults · anyOf 1.words[].startRequired

          number

          Minimum: 0.

          1 field

          • Response 200 · outputResults · anyOf 1.words[].startSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 200 · outputResults · anyOf 1.words[].wordRequired

          string
          1 field

          • Response 200 · outputResults · anyOf 1.words[].wordSee schema

            string

            Expand this value in the interactive reference.

        • Response 200 · outputResults · anyOf 1.words[].confidenceOptional

          number
          1 field

          • Response 200 · outputResults · anyOf 1.words[].confidenceSee schema

            number

            Expand this value in the interactive reference.

        • Response 200 · outputResults · anyOf 1.words[].successOptional

          boolean
          1 field

          • Response 200 · outputResults · anyOf 1.words[].successSee schema

            boolean

            Expand this value in the interactive reference.

  • Response 200 · outputResults · anyOf 2Alternative

    null

• Response 200 · processingDurationRequired

  number | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · processingDuration · anyOf 1Alternative

    number

    Processing duration in milliseconds

  • Response 200 · processingDuration · anyOf 2Alternative

    null

• Response 200 · processingDurationTextRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · processingDurationText · anyOf 1Alternative

    string

    Human-readable processing duration, e.g. 16.2s

  • Response 200 · processingDurationText · anyOf 2Alternative

    null

• Response 200 · statusRequired

  "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED"

  Default: "PENDING".

• Response 200 · taskIdRequired

  string

  Task unique identifier

• Response 200 · pollUrlOptional

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · pollUrl · anyOf 1Alternative

    string

    Set only when the synchronous wait timed out (HTTP 202, status=PROCESSING). The task is still running — poll this URL for the final result. Null/absent on terminal responses.

  • Response 200 · pollUrl · anyOf 2Alternative

    null

• Response 200 · resourcesOptional

  array<object>

  Standardized resources produced by the task

  1 field

  • Response 200 · resources[]Each item

    object

    A consumable resource produced by the task.

    19 fields

    • Response 200 · resources[].idRequired

      string

      Stable resource id (OmnAPI resource id).

    • Response 200 · resources[].indexRequired

      number

      Stable zero-based provider result slot. Finalized post-process resources may use a higher reserved slot.

      Minimum: 0.

    • Response 200 · resources[].roleRequired

      "candidate" | "final" | "stem" | "fallback" | "output"

      How clients should interpret the resource. Prefer `final` when present; `candidate` items remain selectable alternatives.

    • Response 200 · resources[].typeRequired

      "MUSIC" | "IMAGE" | "VIDEO" | "AUDIO" | "TEXT" | "METADATA"

      Uppercase resource kind. MUSIC carries a song URL and optional thumbnailUrl; TEXT carries inline content. Optional fields depend on the operation.

    • Response 200 · resources[].assetIdOptional

      string

      Stable OmnAPI-owned asset id when available.

    • Response 200 · resources[].assetStatusOptional

      "READY" | "EXPIRED" | "DELETING" | "DELETED"

    • Response 200 · resources[].byteLengthOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].byteLength · anyOf 1Alternative

        number

        Resource size in bytes.

      • Response 200 · resources[].byteLength · anyOf 2Alternative

        null

    • Response 200 · resources[].contentOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].content · anyOf 1Alternative

        string

        Inline text content (e.g. lyrics).

      • Response 200 · resources[].content · anyOf 2Alternative

        null

    • Response 200 · resources[].contentTypeOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].contentType · anyOf 1Alternative

        string

        Resource content type.

      • Response 200 · resources[].contentType · anyOf 2Alternative

        null

    • Response 200 · resources[].durationOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].duration · anyOf 1Alternative

        number

      • Response 200 · resources[].duration · anyOf 2Alternative

        null

    • Response 200 · resources[].durationSecOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].durationSec · anyOf 1Alternative

        number

        Resource duration in seconds.

      • Response 200 · resources[].durationSec · anyOf 2Alternative

        null

    • Response 200 · resources[].heightOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].height · anyOf 1Alternative

        number

      • Response 200 · resources[].height · anyOf 2Alternative

        null

    • Response 200 · resources[].metadataOptional

      object | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].metadata · anyOf 1Alternative

        object

      • Response 200 · resources[].metadata · anyOf 2Alternative

        null

    • Response 200 · resources[].retainedUntilOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].retainedUntil · anyOf 1Alternative

        string

        Format: date-time.

      • Response 200 · resources[].retainedUntil · anyOf 2Alternative

        null

    • Response 200 · resources[].thumbnailUrlOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].thumbnailUrl · anyOf 1Alternative

        string

      • Response 200 · resources[].thumbnailUrl · anyOf 2Alternative

        null

    • Response 200 · resources[].titleOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].title · anyOf 1Alternative

        string

      • Response 200 · resources[].title · anyOf 2Alternative

        null

    • Response 200 · resources[].urlOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].url · anyOf 1Alternative

        string

        Presigned/public URL.

      • Response 200 · resources[].url · anyOf 2Alternative

        null

    • Response 200 · resources[].urlExpiresAtOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].urlExpiresAt · anyOf 1Alternative

        string

        Format: date-time.

      • Response 200 · resources[].urlExpiresAt · anyOf 2Alternative

        null

    • Response 200 · resources[].widthOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · resources[].width · anyOf 1Alternative

        number

      • Response 200 · resources[].width · anyOf 2Alternative

        null

202 Accepted

application/json

Unknown fields are not accepted.

• Response 202 · creditsChargedRequired

  number | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · creditsCharged · anyOf 1Alternative

    number

    Exact credits actually charged

    Minimum: 0.

  • Response 202 · creditsCharged · anyOf 2Alternative

    null

• Response 202 · creditsRequiredRequired

  number

  Exact credits deducted to start the task

  Minimum: 0.

• Response 202 · errorCodeRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · errorCode · anyOf 1Alternative

    string

    Error code if task failed

  • Response 202 · errorCode · anyOf 2Alternative

    null

• Response 202 · errorMessageRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · errorMessage · anyOf 1Alternative

    string

    Error message if task failed

  • Response 202 · errorMessage · anyOf 2Alternative

    null

• Response 202 · outputResultsRequired

  object | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · outputResults · anyOf 1Alternative

    object

    Unknown fields are not accepted.

    4 fields

    • Response 202 · outputResults · anyOf 1.clipIdRequired

      string

    • Response 202 · outputResults · anyOf 1.linesRequired

      array<object>
      1 field

      • Response 202 · outputResults · anyOf 1.lines[]Each item

        object

        Unknown fields are not accepted.

        5 fields

        • Response 202 · outputResults · anyOf 1.lines[].endRequired

          number

          Minimum: 0.

          1 field

          • Response 202 · outputResults · anyOf 1.lines[].endSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 202 · outputResults · anyOf 1.lines[].startRequired

          number

          Minimum: 0.

          1 field

          • Response 202 · outputResults · anyOf 1.lines[].startSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 202 · outputResults · anyOf 1.lines[].textRequired

          string
          1 field

          • Response 202 · outputResults · anyOf 1.lines[].textSee schema

            string

            Expand this value in the interactive reference.

        • Response 202 · outputResults · anyOf 1.lines[].wordsRequired

          array<object>
          1 field

          • Response 202 · outputResults · anyOf 1.lines[].wordsSee schema

            array<object>

            Expand this value in the interactive reference.

        • Response 202 · outputResults · anyOf 1.lines[].sectionOptional

          string
          1 field

          • Response 202 · outputResults · anyOf 1.lines[].sectionSee schema

            string

            Expand this value in the interactive reference.

    • Response 202 · outputResults · anyOf 1.waveform_dataRequired

      array<number>
      1 field

      • Response 202 · outputResults · anyOf 1.waveform_data[]Each item

        number

    • Response 202 · outputResults · anyOf 1.wordsRequired

      array<object>
      1 field

      • Response 202 · outputResults · anyOf 1.words[]Each item

        object

        Unknown fields are not accepted.

        5 fields

        • Response 202 · outputResults · anyOf 1.words[].endRequired

          number

          Minimum: 0.

          1 field

          • Response 202 · outputResults · anyOf 1.words[].endSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 202 · outputResults · anyOf 1.words[].startRequired

          number

          Minimum: 0.

          1 field

          • Response 202 · outputResults · anyOf 1.words[].startSee schema

            number

            Expand this value in the interactive reference.

            Minimum: 0.

        • Response 202 · outputResults · anyOf 1.words[].wordRequired

          string
          1 field

          • Response 202 · outputResults · anyOf 1.words[].wordSee schema

            string

            Expand this value in the interactive reference.

        • Response 202 · outputResults · anyOf 1.words[].confidenceOptional

          number
          1 field

          • Response 202 · outputResults · anyOf 1.words[].confidenceSee schema

            number

            Expand this value in the interactive reference.

        • Response 202 · outputResults · anyOf 1.words[].successOptional

          boolean
          1 field

          • Response 202 · outputResults · anyOf 1.words[].successSee schema

            boolean

            Expand this value in the interactive reference.

  • Response 202 · outputResults · anyOf 2Alternative

    null

• Response 202 · processingDurationRequired

  number | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · processingDuration · anyOf 1Alternative

    number

    Processing duration in milliseconds

  • Response 202 · processingDuration · anyOf 2Alternative

    null

• Response 202 · processingDurationTextRequired

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · processingDurationText · anyOf 1Alternative

    string

    Human-readable processing duration, e.g. 16.2s

  • Response 202 · processingDurationText · anyOf 2Alternative

    null

• Response 202 · statusRequired

  "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED"

  Default: "PENDING".

• Response 202 · taskIdRequired

  string

  Task unique identifier

• Response 202 · pollUrlOptional

  string | null

  May be null. Must match at least one alternative.

  2 fields / alternatives

  • Response 202 · pollUrl · anyOf 1Alternative

    string

    Set only when the synchronous wait timed out (HTTP 202, status=PROCESSING). The task is still running — poll this URL for the final result. Null/absent on terminal responses.

  • Response 202 · pollUrl · anyOf 2Alternative

    null

• Response 202 · resourcesOptional

  array<object>

  Standardized resources produced by the task

  1 field

  • Response 202 · resources[]Each item

    object

    A consumable resource produced by the task.

    19 fields

    • Response 202 · resources[].idRequired

      string

      Stable resource id (OmnAPI resource id).

    • Response 202 · resources[].indexRequired

      number

      Stable zero-based provider result slot. Finalized post-process resources may use a higher reserved slot.

      Minimum: 0.

    • Response 202 · resources[].roleRequired

      "candidate" | "final" | "stem" | "fallback" | "output"

      How clients should interpret the resource. Prefer `final` when present; `candidate` items remain selectable alternatives.

    • Response 202 · resources[].typeRequired

      "MUSIC" | "IMAGE" | "VIDEO" | "AUDIO" | "TEXT" | "METADATA"

      Uppercase resource kind. MUSIC carries a song URL and optional thumbnailUrl; TEXT carries inline content. Optional fields depend on the operation.

    • Response 202 · resources[].assetIdOptional

      string

      Stable OmnAPI-owned asset id when available.

    • Response 202 · resources[].assetStatusOptional

      "READY" | "EXPIRED" | "DELETING" | "DELETED"

    • Response 202 · resources[].byteLengthOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].byteLength · anyOf 1Alternative

        number

        Resource size in bytes.

      • Response 202 · resources[].byteLength · anyOf 2Alternative

        null

    • Response 202 · resources[].contentOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].content · anyOf 1Alternative

        string

        Inline text content (e.g. lyrics).

      • Response 202 · resources[].content · anyOf 2Alternative

        null

    • Response 202 · resources[].contentTypeOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].contentType · anyOf 1Alternative

        string

        Resource content type.

      • Response 202 · resources[].contentType · anyOf 2Alternative

        null

    • Response 202 · resources[].durationOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].duration · anyOf 1Alternative

        number

      • Response 202 · resources[].duration · anyOf 2Alternative

        null

    • Response 202 · resources[].durationSecOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].durationSec · anyOf 1Alternative

        number

        Resource duration in seconds.

      • Response 202 · resources[].durationSec · anyOf 2Alternative

        null

    • Response 202 · resources[].heightOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].height · anyOf 1Alternative

        number

      • Response 202 · resources[].height · anyOf 2Alternative

        null

    • Response 202 · resources[].metadataOptional

      object | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].metadata · anyOf 1Alternative

        object

      • Response 202 · resources[].metadata · anyOf 2Alternative

        null

    • Response 202 · resources[].retainedUntilOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].retainedUntil · anyOf 1Alternative

        string

        Format: date-time.

      • Response 202 · resources[].retainedUntil · anyOf 2Alternative

        null

    • Response 202 · resources[].thumbnailUrlOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].thumbnailUrl · anyOf 1Alternative

        string

      • Response 202 · resources[].thumbnailUrl · anyOf 2Alternative

        null

    • Response 202 · resources[].titleOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].title · anyOf 1Alternative

        string

      • Response 202 · resources[].title · anyOf 2Alternative

        null

    • Response 202 · resources[].urlOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].url · anyOf 1Alternative

        string

        Presigned/public URL.

      • Response 202 · resources[].url · anyOf 2Alternative

        null

    • Response 202 · resources[].urlExpiresAtOptional

      string | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].urlExpiresAt · anyOf 1Alternative

        string

        Format: date-time.

      • Response 202 · resources[].urlExpiresAt · anyOf 2Alternative

        null

    • Response 202 · resources[].widthOptional

      number | null

      May be null. Must match at least one alternative.

      2 fields / alternatives

      • Response 202 · resources[].width · anyOf 1Alternative

        number

      • Response 202 · resources[].width · anyOf 2Alternative

        null

400 Bad Request

application/json

• Response 400 · errorRequired

  object
  3 fields

  • Response 400 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 400 · error.messageRequired

    string

    Human readable error message

  • Response 400 · error.detailsOptional

    object

    Additional error details (optional)

• Response 400 · successRequired

  false

  Always false for error responses

401 Unauthorized

application/json

• Response 401 · errorRequired

  object
  3 fields

  • Response 401 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 401 · error.messageRequired

    string

    Human readable error message

  • Response 401 · error.detailsOptional

    object

    Additional error details (optional)

• Response 401 · successRequired

  false

  Always false for error responses

402 Payment Required

application/json

• Response 402 · errorRequired

  object
  3 fields

  • Response 402 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 402 · error.messageRequired

    string

    Human readable error message

  • Response 402 · error.detailsOptional

    object

    Additional error details (optional)

• Response 402 · successRequired

  false

  Always false for error responses

403 Forbidden

Forbidden: the API key lacks the required scope or its IP policy rejects this request. Forbidden: API-key scope/IP restrictions or billing hold. A positive balance does not bypass payment review. Check GET /api/v1/account/credits billingStatus before further paid requests.

application/json

• Response 403 · errorRequired

  object
  3 fields

  • Response 403 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 403 · error.messageRequired

    string

    Human readable error message

  • Response 403 · error.detailsOptional

    object

    Additional error details (optional)

• Response 403 · successRequired

  false

  Always false for error responses

422 Unprocessable Entity

application/json

• Response 422 · errorRequired

  object
  3 fields

  • Response 422 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 422 · error.messageRequired

    string

    Human readable error message

  • Response 422 · error.detailsOptional

    object

    Additional error details (optional)

• Response 422 · successRequired

  false

  Always false for error responses

429 Too Many Requests

Request allowance or task admission capacity exceeded. Follow Retry-After when present; otherwise wait for active tasks and use bounded backoff. Limits do not guarantee throughput. For SSE, this is the HTTP connection response, not an event.

application/json

• Response 429 · errorRequired

  object
  3 fields

  • Response 429 · error.codeRequired

    string

    RATE_LIMITED for request and task admission rejections.

  • Response 429 · error.messageRequired

    string

  • Response 429 · error.detailsOptional

    object

    Optional and scope-dependent. Request limits supply scope/policy/type/limit/current/retryAfterSec. Task admission supplies inFlight/limit/tier, plus scope=apiKey for a key cap. IP rejection can omit details. In-flight rejection does not promise Retry-After.

    8 fields

    • Response 429 · error.details.currentOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.inFlightOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.limitOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.policyOptional

      "operation" | "query"

    • Response 429 · error.details.retryAfterSecOptional

      integer

      Minimum: 1.

    • Response 429 · error.details.scopeOptional

      "user" | "api-key" | "ip" | "apiKey"

    • Response 429 · error.details.tierOptional

      "FREE" | "PREMIUM" | "ENTERPRISE"

    • Response 429 · error.details.typeOptional

      "rps" | "daily" | "monthly"

• Response 429 · successRequired

  false

  Default: false.

500 Internal Server Error

application/json

• Response 500 · errorRequired

  object
  3 fields

  • Response 500 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 500 · error.messageRequired

    string

    Human readable error message

  • Response 500 · error.detailsOptional

    object

    Additional error details (optional)

• Response 500 · successRequired

  false

  Always false for error responses

503 Service Unavailable

application/json

• Response 503 · errorRequired

  object
  3 fields

  • Response 503 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 503 · error.messageRequired

    string

    Human readable error message

  • Response 503 · error.detailsOptional

    object

    Additional error details (optional)

• Response 503 · successRequired

  false

  Always false for error responses

Request example

Wrap lines

cURL

curl --globoff --request GET \
  --url 'https://api.omnapi.com/api/v1/suno/clips/{clipId}/timeline' \
  --header "x-api-key: $OMNAPI_KEY"

Node.js

const response = await fetch("https://api.omnapi.com/api/v1/suno/clips/{clipId}/timeline", {
  method: "GET",
  headers: {
    "x-api-key": process.env.OMNAPI_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import os
import requests

response = requests.request(
    "GET", "https://api.omnapi.com/api/v1/suno/clips/{clipId}/timeline",
    headers={
        "x-api-key": os.environ["OMNAPI_KEY"],
    },
    timeout=60,
)
response.raise_for_status()
print(response.text)

Set URL and header variables.

Interactive API Explorer → · OpenAPI JSON