# APIstable ## Getting started with APIstable - [Your first request](https://docs.apistable.ai/quickstart.md): Generate music with the common task API and read the returned songs. - [Authentication](https://docs.apistable.ai/authentication.md): One API key for submission and account queries. ### Common APIs and guides - [Create task](https://docs.apistable.ai/create-task.md): Submit image, video or music generation. - [Query task](https://docs.apistable.ai/query-task.md): Read the final task result and total charged Credits. - [List tasks](https://docs.apistable.ai/list-tasks.md): Cursor pagination for account-owned task summaries. - [Result JSON](https://docs.apistable.ai/outputs.md): Read model-specific structured results. - [Available Credits](https://docs.apistable.ai/credits.md): Read available account Credits. - [Task webhooks](https://docs.apistable.ai/webhooks.md): Receive terminal task notifications. - [Webhook signing secret](https://docs.apistable.ai/webhook-secret.md): Retrieve your account-specific HMAC verification secret. - [Errors and retries](https://docs.apistable.ai/errors.md): HTTP status, business codes and generation errors. - [Official fallback](https://docs.apistable.ai/fallback.md): Authorize fallback only on supporting models. - [LLM integration](https://docs.apistable.ai/llm.md): Chat Completions integration boundary. ### File uploads - [file upload](https://docs.apistable.ai/file-upload.md): Get a public media URL, available for 24 hours. - [file upload url](https://docs.apistable.ai/file-upload-url.md): Get a public media URL, available for 24 hours. - [file upload base64](https://docs.apistable.ai/file-upload-base64.md): Get a public media URL, available for 24 hours. ## Market - [List models](https://docs.apistable.ai/models.md): List models available for live execution. - [Model schemas](https://docs.apistable.ai/model-details.md): Inspect the exact model input and result schemas. ### Image models - [Image models](https://docs.apistable.ai/image-models.md): No models are connected in this category yet. ### Video models - [Video models](https://docs.apistable.ai/video-models.md): No models are connected in this category yet. ### Music models #### Suno - [Music tasks](https://docs.apistable.ai/music.md): One execution can return two native works. - [Register audio](https://docs.apistable.ai/suno-upload.md): Register an existing audio URL to obtain an APIstable audio ID for covering or extending it. - [Generate music](https://docs.apistable.ai/suno-generate.md): Describe the piece and supply a style or references. Custom mode lets you write the lyrics yourself. - [Extend music](https://docs.apistable.ai/suno-extend.md): Provide an audio ID and the point to continue from. For generated songs, select the source song’s model version. - [Cover a song](https://docs.apistable.ai/suno-cover.md): Choose a song on APIstable and set a new style and lyrics for a different performance. This operation accepts an audio ID. - [Replace a section](https://docs.apistable.ai/suno-replace-section.md): Select a time range within a song and rewrite that section with new lyrics or style. - [Add instrumental backing](https://docs.apistable.ai/suno-add-instrumental.md): Start with a vocal audio URL and describe the backing arrangement to accompany it. - [Add vocals](https://docs.apistable.ai/suno-add-vocals.md): Provide an instrumental URL and lyrics to add a vocal performance. - [Add an instrumental stem](https://docs.apistable.ai/suno-add-stem.md): Add a selected instrumental part to existing audio. Receive the new part or wait for the mix. - [Aligned lyrics](https://docs.apistable.ai/suno-lyrics-timestamps.md): Get word alignment for an audio ID, optionally providing the lyrics to align. - [Upload a Voice sample](https://docs.apistable.ai/suno-voice-upload.md): Upload a voice sample and select a segment, then request a phrase, record verification, and check the created Voice. - [Verify and create Voice](https://docs.apistable.ai/suno-voice-create.md): Submit your recording of the verification phrase using the task ID and phrase ID from the same sample upload. - [Export WAV](https://docs.apistable.ai/suno-export-wav.md): Export an APIstable song as WAV and retrieve its file link through the common task endpoint. - [Download MP3](https://docs.apistable.ai/suno-export-mp3.md): Use this operation when you need an MP3 file. A song’s playback URL may contain M4A audio. - [Export MIDI](https://docs.apistable.ai/suno-export-midi.md): Select an APIstable audio ID to extract MIDI data. External audio uploads are not accepted here. - [Vocal remover and stems](https://docs.apistable.ai/suno-separate-vocals.md): Use an audio URL for toolbox separation or an APIstable audio ID for native stems, then listen to and download individual parts. - [Prepare a song Voice Persona](https://docs.apistable.ai/suno-persona-prepare.md): Prepare vocal material from an APIstable song, then select a 10–30 second segment to create a Voice Persona. - [Create Persona from a song](https://docs.apistable.ai/suno-persona-create.md): A style Persona uses an audio ID directly. A Voice Persona uses prepared material and a selected segment. - [Voice and Persona workflows](https://docs.apistable.ai/suno-voice-workflow.md): Record, verify, create and reuse a singing voice. - [Get verification phrase](https://docs.apistable.ai/voice-verification-phrase.md): Choose a language or regenerate a phrase. - [Check Voice availability](https://docs.apistable.ai/voice-availability.md): Check a resource owned by your account. ## OpenAPI Specs - [openapi](/openapi.json) - [openapi-suno-upload](/openapi-suno-upload.json) - [openapi-suno-generate](/openapi-suno-generate.json) - [openapi-suno-extend](/openapi-suno-extend.json) - [openapi-suno-cover](/openapi-suno-cover.json) - [openapi-suno-replace-section](/openapi-suno-replace-section.json) - [openapi-suno-add-instrumental](/openapi-suno-add-instrumental.json) - [openapi-suno-add-vocals](/openapi-suno-add-vocals.json) - [openapi-suno-add-stem](/openapi-suno-add-stem.json) - [openapi-suno-lyrics-timestamps](/openapi-suno-lyrics-timestamps.json) - [openapi-suno-voice-upload](/openapi-suno-voice-upload.json) - [openapi-suno-voice-create](/openapi-suno-voice-create.json) - [openapi-suno-export-wav](/openapi-suno-export-wav.json) - [openapi-suno-export-mp3](/openapi-suno-export-mp3.json) - [openapi-suno-export-midi](/openapi-suno-export-midi.json) - [openapi-suno-separate-vocals](/openapi-suno-separate-vocals.json) - [openapi-suno-persona-prepare](/openapi-suno-persona-prepare.json) - [openapi-suno-persona-create](/openapi-suno-persona-create.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Chinese (40 pages)](https://docs.apistable.ai/_llms/cn.txt): Documentation for Chinese. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.