# AI Music API

> REST API documentation for AI music generation, extension, cover workflows, lyric timing, task polling, and account credits.

## Core Links

- [Home](https://udioapi.pro/): Product overview and entry point for the AI music API platform.
- [API Documentation](https://udioapi.pro/docs): Endpoint directory with authentication, request fields, examples, polling, credit costs, and webhook behavior.
- [Pricing](https://udioapi.pro/pricing): Available credit plans and account top-up options for API usage.

## API Documentation

- [Music Generate API](https://udioapi.pro/docs/v2-generate): Creates asynchronous AI music tasks in inspiration or custom mode, with model selection and webhook support.
- [Extend Music API](https://udioapi.pro/docs/v2-extend): Extends a completed generated track while inheriting its settings or applying new lyrics and style controls.
- [Music Cover Image API](https://udioapi.pro/docs/generate-music-cover): Creates cover artwork for a completed music task and explains how to poll the cover task status.
- [Timestamped Lyrics API](https://udioapi.pro/docs/v2-timestamped-lyrics): Returns word-level lyric timestamps and alignment data for a selected audio result from a generation task.
- [Upload and Cover API](https://udioapi.pro/docs/v2-upload-cover): Creates an AI cover from a public audio URL and documents generation, polling, model, and duration constraints.
- [Task Status API](https://udioapi.pro/docs/v2-feed): Polls a public workId until music generation succeeds or fails and returns the generated audio results.
- [Credits API](https://udioapi.pro/docs/query-credits): Returns the authenticated account credit balance and total consumed credits for usage monitoring.
- [Callback Music Generate API](https://udioapi.pro/docs/generate-callback): Creates a music task with a public callback URL and documents the asynchronous webhook payload sequence.
- [WAV Conversion API](https://udioapi.pro/docs/v2-wav-conversion): Converts a generated audio result to WAV while keeping the public task ID for polling, logs, and webhooks.
- [MiniMax Music API](https://udioapi.pro/docs/v2-minimax-generate): Creates and polls asynchronous MiniMax music tasks through the dedicated provider-specific public endpoints.

## Key Facts

- Public API base URL: https://udioapi.pro/api
- Authentication: `Authorization: Bearer YOUR_API_KEY` for endpoints that require an account.
- Async create endpoints return a public task ID; use that same ID for status polling, logs, and user webhooks.
- Provider task IDs, upstream responses, service credentials, and internal routing details are not public API inputs.
- Follow the status values and polling interval documented for each endpoint; most async tasks should be polled every 5-10 seconds.

## Integration Notes

- Keep API keys on the server and never expose them in browser code or public repositories.
- Use the exact field names and task ID format shown on the endpoint page being integrated.
- Treat callbacks as asynchronous notifications and verify the task through the documented status endpoint when needed.

## Contact

- Website: https://udioapi.pro
- Support: support@udioapi.pro