Skip to main content
Base URL https://app.contenthero.ai/api/v1. All endpoints take a bearer API key.

Generation

MethodPathScopePurpose
POST/studio/generategenerateImage, video, audio, lip-sync, or upscale, selected by type. Smart-waits, then returns the asset or an outputId. Pass getCost: true to preview cost only.
GET/studio/generate/{outputId}generateGeneration status and result for a pending outputId. Includes a pollAfterSeconds hint while in progress.
POST/studio/reference-boardgenerateGenerate a reference board from a source image and a board type.
POST/studio/transcribegenerateTranscribe a media file to text.
A generation reference (start frame, image input, audio) accepts a raw URL or a ContentHero output-id token <uuid>-<N>.

Models

MethodPathScopePurpose
GET/modelsreadThe live model roster, resolved from the registry. The authoritative list of valid modelId values.

Media

MethodPathScopePurpose
GET/mediareadList your media (creations, boards, looks), filterable by kind.
GET/media/{token}readGet one media item by id or output-id token.

Avatars and voices

MethodPathScopePurpose
GET/avatarsreadList your avatars.
GET/avatars/{avatarId}readGet one avatar with its looks.
GET/voicesreadList available voices.
GET/voices/{voiceId}readGet one voice.
See the Generate guide for the workflow, chaining, and cost preflight.