# Sunor API

- [Sunor API Documentation](https://docs.sunor.cc/introduction.md): Sunor API documentation for unified Suno and Udio access, including authentication, credits, billing controls, REST endpoints, and code examples.
- [Authentication](https://docs.sunor.cc/authentication.md): Authenticate your Sunor API requests with an x-api-key header. Get your API key from the Sunor dashboard.
- [Credits](https://docs.sunor.cc/credits.md): Pay-as-you-go credits for the sunor API. Suno music 10 credits ($0.10), Udio music 5 credits ($0.05), Suno lyrics 5 credits, no subscription.
- [Automatic Top-Up](https://docs.sunor.cc/billing/automatic-top-up.md): Configure optional Stripe Automatic Top-Up in Sunor with a balance threshold, recharge amount, monthly cap, explicit authorization, and payment recovery.
- [Billing Information and PDF Invoices](https://docs.sunor.cc/billing/invoices.md): Save customer-supplied billing information and download private PDF invoices for completed Sunor card, crypto, and Automatic Top-Up purchases.
- [Suno Model](https://docs.sunor.cc/models/suno.md): Generate music, lyrics, and audio with the Suno V5.5 API. Supports inspiration mode, custom lyrics, continuation, and audio upload.
- [Udio Model](https://docs.sunor.cc/models/udio.md): Generate music with the Udio AI music model. Single-call generation with optional user-supplied lyrics or instrumental output.
- [Complete Workflow](https://docs.sunor.cc/guides/complete-workflow.md): End-to-end guide: create a task, poll for results, and use the output
- [Error Codes](https://docs.sunor.cc/errors.md): HTTP error codes and error response format
- [Rate Limits](https://docs.sunor.cc/rate-limits.md): API rate limiting policies and response headers
- [Changelog](https://docs.sunor.cc/changelog.md): What's new in the sunor API
- [Create Task](https://docs.sunor.cc/api-reference/create-task.md): Submit a new AI generation task
- [Get Task](https://docs.sunor.cc/api-reference/get-task.md): Retrieve the status and output of a task
- [Get Balance](https://docs.sunor.cc/api-reference/get-balance.md): Check your current credit balance
- [Get Usage](https://docs.sunor.cc/api-reference/get-usage.md): Retrieve your account usage statistics

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)
- [openapi](/openapi.yaml)