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

# Assets and hosts

> Reuse the existing Podcastor libraries for voices, avatars, images and music.

## Discover existing assets

[Catalog](/api-reference/account/catalog) searches the shared voice, avatar or template libraries using `kind`. For library-specific filters, use the dedicated listing endpoints and their schemas. [Capabilities](/api-reference/account/capabilities) describes the atomic workflow and shared identity.

| Asset                   | Find or create                                                                                                                             | Continue with                                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Voice                   | [List voices](/api-reference/voices/list-voices), [clone](/api-reference/voices/clone-voice), [design](/api-reference/voices/design-voice) | [Get voice](/api-reference/voices/get-voice), [save designed voice](/api-reference/voices/save-designed-voice)                                                           |
| Avatar                  | [List avatars](/api-reference/avatars/list-avatars), [create photos](/api-reference/avatars/create-avatar)                                 | [Get avatar](/api-reference/avatars/get-avatar), [generate motion](/api-reference/avatars/generate-avatar-motion)                                                        |
| Background or cover     | [Generate image](/api-reference/assets/generate-image)                                                                                     | [Get image task](/api-reference/assets/get-image-task)                                                                                                                   |
| Music                   | [List music](/api-reference/assets/list-music), [user music](/api-reference/assets/list-user-music)                                        | [Register music](/api-reference/assets/add-music)                                                                                                                        |
| Visual podcast template | [List image templates](/api-reference/templates/list-image-templates)                                                                      | [Create](/api-reference/templates/create-image-template), [update](/api-reference/templates/update-image-template), [copy](/api-reference/templates/copy-image-template) |

Voice cloning, design, avatar generation and image generation use the existing subscription allowances and charges. Check [voice clone allowance](/api-reference/voices/voice-clone-allowance) before cloning.

## Upload your media

1. Request [Upload sign](/api-reference/assets/upload-sign) with the file metadata required by its schema.
2. Upload the bytes directly to the returned OSS destination using the supplied signing fields. Do not send raw file bytes to the signing endpoint.
3. Register the resulting media URL through the matching operation, such as [Add music](/api-reference/assets/add-music), [Add background](/api-reference/assets/add-background) or [Add image](/api-reference/templates/add-image).
4. Use the returned asset ID in your project or template settings.

An upload alone does not necessarily create a library item. Use the relevant registration operation and preserve its native ID. The API does not create a separate asset store.

## Generate a background or cover

For [Generate image](/api-reference/assets/generate-image), use the endpoint's supported `source`: `podcast_background` for backgrounds or `podcast_cover` for covers. Poll the returned task through [Get image task](/api-reference/assets/get-image-task).

For covers, [Get cover context](/api-reference/rendering/cover-context) provides project context and [Set cover](/api-reference/rendering/set-cover) attaches a selected cover to the project.

## Visual podcasts

Use image templates, image backgrounds, image materials and waveforms to build reusable visual podcast layouts. Their CRUD operations use the Web library's public/user ownership rules. Copies create editable user templates; deletion remains subject to the existing access checks.