> ## Documentation Index > Fetch the complete documentation index at: https://docs.rawugc.com/llms.txt > Use this file to discover all available pages before exploring further. # Get music track > Get a music track by ID. Returns full details including status, model, audio URL, album art, and duration when completed. ## OpenAPI ````yaml /openapi.json get /music/{musicId} openapi: 3.0.0 info: title: RawUGC API version: 1.0.0 description: >- Generate AI videos, images, and music, and schedule social media posts programmatically. contact: name: API Support email: support@rawugc.com url: https://docs.rawugc.com license: name: Proprietary servers: - url: https://rawugc.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Tasks description: >- Deprecated. Use typed resource endpoints instead: GET /videos/{videoId}, GET /images/{imageId}, GET /music/{musicId}. - name: Image Generation description: >- Generate and edit AI images using Nano Banana models. Supports text-to-image generation (6 credits) and image-to-image editing (2 credits). - name: Video Generation description: Generate and manage AI videos using Sora 2, Kling, and Veo 3 models - name: Personas description: Manage target audience personas for content plans - name: Messaging description: Manage brand/positioning messaging for content plans - name: Products description: Manage products for video generation - name: Styles description: Manage video creative styles and templates - name: Characters description: List available AI characters for video generation - name: Video Editing description: Post-process videos with captions, overlays, and effects - name: Upload description: Upload video and image files for use in generation requests - name: Social Scheduling description: Schedule and manage social media posts to TikTok, Instagram, and YouTube - name: Social Accounts description: Manage connected social media accounts - name: Music Generation description: >- Generate AI music tracks using Suno models with customizable genre, mood, and style - name: Viral Library description: >- Browse and search analyzed TikTok videos across the platform. Includes AI-powered analysis with hooks, keyframes, performance insights, and semantic search via natural language queries. - name: Research description: >- Scrape TikTok videos, analyze any video, and generate content plans. Tools for competitive research and content strategy. paths: /music/{musicId}: get: tags: - Music Generation summary: Get music track description: >- Get a music track by ID. Returns full details including status, model, audio URL, album art, and duration when completed. operationId: getMusic parameters: - name: musicId in: path required: true schema: type: string description: Music identifier (mus_xxx format) responses: '200': description: Music generation status headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests per window X-RateLimit-Remaining: schema: type: integer description: Remaining requests in current window X-RateLimit-Reset: schema: type: integer description: Unix timestamp when the rate limit resets content: application/json: schema: $ref: '#/components/schemas/MusicResponse' examples: pending: summary: Still generating value: musicId: mus_jh7a3b9xq2pn4r8k status: pending model: V5 prompt: upbeat lo-fi hip hop beat creditsUsed: 3 createdAt: 1740000000000 completed: summary: Generation complete value: musicId: mus_jh7a3b9xq2pn4r8k status: completed model: V5 prompt: upbeat lo-fi hip hop beat audioUrl: https://cdn.example.com/audio/track.mp3 albumArtUrl: https://cdn.example.com/images/cover.jpg duration: 120 title: Lo-Fi Sunset creditsUsed: 3 createdAt: 1740000000000 completedAt: 1740000120000 failed: summary: Generation failed value: musicId: mus_jh7a3b9xq2pn4r8k status: failed model: V5 prompt: upbeat lo-fi hip hop beat creditsUsed: 3 createdAt: 1740000000000 failCode: GENERATE_AUDIO_FAILED failMessage: 'Music generation failed: GENERATE_AUDIO_FAILED' '401': description: Authentication error content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Task not found content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: MusicResponse: type: object properties: musicId: type: string description: Unique music identifier (mus_xxx format) status: type: string enum: - pending - processing - completed - failed description: Current generation status model: type: string description: Suno model version used prompt: type: string description: Text prompt used for generation audioUrl: type: string format: uri description: >- URL to download the generated audio (available when status is 'completed') albumArtUrl: type: string format: uri description: URL for the generated album art image duration: type: number description: Track duration in seconds title: type: string description: Track title creditsUsed: type: number description: Credits deducted for this generation createdAt: type: number description: Timestamp when generation was initiated completedAt: type: number description: Timestamp when generation completed (if finished) failCode: type: string description: Error code if generation failed failMessage: type: string description: Error message if generation failed ApiError: type: object properties: type: type: string format: uri description: >- URI reference identifying the problem type (e.g., https://api.rawugc.com/errors/validation_error) title: type: string description: Short, human-readable summary of the problem status: type: number description: HTTP status code detail: type: string description: Human-readable explanation of the problem instance: type: string format: uri description: URI reference identifying this specific occurrence errors: type: object additionalProperties: type: array items: type: string description: Field-specific validation errors securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY ````