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

# ACE Music Lyrics

> Generate a title and editable lyrics. This is a separate paid operation; generating a song does not implicitly invoke it.



## OpenAPI

````yaml /openapi/acemusic.json post /acemusic/lyrics
openapi: 3.0.0
info:
  title: ACE Music
  version: 1.0.0
  description: API reference for ACE Music on Ace Data Cloud.
servers:
  - url: https://api.acedata.cloud
    description: Ace Data Cloud API
security:
  - bearerAuth: []
paths:
  /acemusic/lyrics:
    post:
      tags:
        - ACE Music
      summary: ACE Music Lyrics
      description: >-
        Generate a title and editable lyrics. This is a separate paid operation;
        generating a song does not implicitly invoke it.
      operationId: acemusic_lyrics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 20000
                style:
                  type: string
                  maxLength: 20000
      responses:
        '200':
          description: >-
            Request accepted or result available. Inspect the task state before
            treating generation as complete.
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - task_id
                  - data
                properties:
                  success:
                    type: boolean
                  task_id:
                    type: string
                  trace_id:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - title
                        - text
                      properties:
                        title:
                          type: string
                        text:
                          type: string
        '202':
          description: >-
            Durable task accepted. Save task_id and query the original task;
            this is not a completed result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - task_id
                properties:
                  task_id:
                    type: string
                  trace_id:
                    type: string
                  status:
                    type: string
        '400':
          description: Invalid request or unsupported model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '401':
          description: Invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '402':
          description: Insufficient balance for a paid operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '403':
          description: Access denied or content rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '404':
          description: Task not found for this caller.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '409':
          description: Idempotency key reused with a different request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
        '500':
          description: Service failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceMusicError'
      security:
        - bearerAuth: []
components:
  schemas:
    AceMusicError:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        task_id:
          type: string
        trace_id:
          type: string
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````

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