Assets and hosts - Podcastor

Discover existing assets

Catalog searches the shared voice, avatar or template libraries using kind. For library-specific filters, use the dedicated listing endpoints and their schemas. Capabilities describes the atomic workflow and shared identity.

Asset	Find or create	Continue with
Voice	List voices, clone, design	Get voice, save designed voice
Avatar	List avatars, create photos	Get avatar, generate motion
Background or cover	Generate image	Get image task
Music	List music, user music	Register music
Visual podcast template	List image templates	Create, update, copy

Voice cloning, design, avatar generation and image generation use the existing subscription allowances and charges. Check voice clone allowance before cloning.

Upload your media

Request Upload sign with the file metadata required by its schema.
Upload the bytes directly to the returned OSS destination using the supplied signing fields. Do not send raw file bytes to the signing endpoint.
Register the resulting media URL through the matching operation, such as Add music, Add background or Add image.
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, use the endpoint’s supported source: podcast_background for backgrounds or podcast_cover for covers. Poll the returned task through Get image task. For covers, Get cover context provides project context and 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.