stability-ai/stable-avatar
Stable Avatar by stability-ai - advanced AI model for audio-to-video. Delivers high-quality results with fast inference, suitable for both creative and production workflows.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runstability-ai/stable-avatarInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | The URL of the image to use as a reference for the video generation. |
prompt | string | Required | The prompt to use for the video generation. |
audio | string | Optional | The URL of the audio to use as a reference for the video generation. |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "stability-ai/stable-avatar",
"audio": "https://static.sandbase.ai/examples/stability-ai/stable-avatar/input_audio_1.mp3",
"image": "https://static.sandbase.ai/examples/stability-ai/stable-avatar/input_image_0.png",
"prompt": "A person is in a relaxed pose. As the video progresses, the character speaks while arm and body movements are minimal and consistent with a natural speaking posture. Hand movements remain minimal. Don't blink too often. Preserve background integrity matching the reference image's spatial configuration, lighting conditions, and color temperature."
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Stable Avatar
Stable Avatar occupies a clearly bounded position in a video production pipeline under the route stability-ai/stable-avatar. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.
A practical rollout of Stable Avatar should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final stable avatar deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity stability-ai/stable-avatar.
Highlights
- Distinct output behavior. For Stable Avatar, for Stable Avatar, anchor the video with the required image URL In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with audio as a relevant request control; the audio control exposes the corresponding choice in this route; the audio control exposes the corresponding choice in this route.
- Creative control. For Stable Avatar, for Stable Avatar, provide a reference soundtrack or speech clip through the audio URL field In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with image as a relevant request control; the image control exposes the corresponding choice in this route; the image control exposes the corresponding choice in this route.
- Workflow fit. For Stable Avatar, for Stable Avatar, describe the requested video behavior in the required prompt In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with prompt as a relevant request control; the prompt control exposes the corresponding choice in this route; the prompt control exposes the corresponding choice in this route.
- Production detail. For Stable Avatar, for Stable Avatar, select from ten output aspect ratios In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with aspect ratio as a relevant request control; the aspect ratio control exposes the corresponding choice in this route; the aspect ratio control exposes the corresponding choice in this route.
Pricing
| Configuration | Price |
|---|---|
| Minimum charge (4 seconds) | $0.4 |
| Each billable second | $0.1 |
When to Use
| Scenario | Why this model fits |
|---|---|
| Choose Stable Avatar | Use it when the required deliverable is specifically the audio-to-video result documented for stability-ai/stable-avatar. |
| Match the source material | Select this route when your inputs naturally map to audio, image, prompt, aspect_ratio. |
| Use its distinguishing capability | For Stable Avatar, anchor the video with the required image URL In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with audio as a relevant request control; the audio control exposes the corresponding choice in this route |
| Plan repeatable production | For Stable Avatar, provide a reference soundtrack or speech clip through the audio URL field In Stable Avatar, this capability is applied through the exact stability-ai/stable-avatar workflow with image as a relevant request control; the image control exposes the corresponding choice in this route |
| Confirm cost and delivery | Use the pricing combinations below and the output contract above when budgeting or automating Stable Avatar jobs. |
Prompt Guide
Build the request around the exact stability-ai/stable-avatar schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.
{
"image": "https://static.sandbase.ai/examples/stability-ai/stable-avatar/input_image_0.png",
"prompt": "A person is in a relaxed pose. As the video progresses, the character speaks while arm and body movements are minimal and consistent with a natural speaking posture. Hand movements remain minimal. Don't blink too often. Preserve background integrity matching the reference image's spatial configuration, lighting conditions, and color temperature.",
"audio": "https://static.sandbase.ai/examples/stability-ai/stable-avatar/input_audio_1.mp3",
"aspect_ratio": "21:9"
}
Technical Specs
| Specification | Value |
|---|---|
| Model ID | stability-ai/stable-avatar |
| Execution mode | async |
| Required inputs | prompt, image |
| Request fields | audio (string, optional); image (string, required); prompt (string, required); aspect_ratio (string, optional, options: 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16) |
| Output | url (string); content_type (string) |