API reference · ByteDance

bytedance/omnihuman/1.5

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

VIDEOAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbytedance/omnihuman/1.5

Input Schema

6 parameters · 3 required · 3 optional

Parameter	Type	Required	Description
`audio`	string	Required	The URL of the audio file to generate the video. Audio must be under 30s long for 1080p generation and under 60s long for 720p generation.
`image`	string	Required	The URL of the image used to generate the video
`prompt`	string	Required	The text prompt used to guide the video generation.
`mask`	string	Optional	The URL of the mask image to apply to the image. Only the person in the white area of the mask will speak.
`resolution`	string	Optional	The resolution of the generated video. Defaults to 1080p. 720p generation is faster and higher in quality. 1080p generation is limited to 30s audio and 720p generation is limited to 60s audio. · Options: 720p, 1080p · Default: "720p" 720p1080p
`turbo_mode`	boolean	Optional	Generate a video at a faster rate with a slight quality trade-off. · Default: false

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, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "bytedance/omnihuman/1.5",
    "audio": "https://static.sandbase.ai/examples/bytedance/omnihuman/1.5/input_audio_0.mp3",
    "image": "https://static.sandbase.ai/examples/bytedance/omnihuman/1.5/input_image_1.png",
    "resolution": "720p",
    "turbo_mode": false
  }),
});

if (!response.ok) throw new Error(await response.text());
let result = await response.json();
for (let attempt = 0; attempt < 120 && !["completed", "failed", "timeout"].includes(result.status); attempt++) {
  await new Promise((resolve) => setTimeout(resolve, 2_000));
  const poll = await fetch(`https://api.sandbase.ai/v1/run/${result.id}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });
  if (!poll.ok) throw new Error(await poll.text());
  result = await poll.json();
}
if (result.status !== "completed") throw new Error(`Generation ended: ${result.status}`);
console.log(result);

← Back to ByteDance OmniHuman 1.5