Using OmniHuman 1.5 in your workflow
Sorceress brings ByteDance models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.
- Explore motion and scene concepts.
- Automate video generation with a saved job that your application can track.
Credits & pricing
27 credits per second
1 credit = $0.01 · Successful work is billed on completion.Pricing options
Rates are per second. Duration and quantity apply as shown in the input schema; media totals round up to whole credits.
Review the supported inputs for duration, quantity and other usage-based charges before submitting. Read the billing guide →
Inputs and supported options
{
"type": "object",
"required": [
"image_url",
"audio_url"
],
"properties": {
"seed": {
"type": "integer",
"title": "Seed",
"default": -1,
"description": "Random seed. Default is `-1` (random). When using the same positive integer and keeping all other parameters identical, the result will be highly consistent."
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 300,
"description": "Optional. Supported languages: Chinese, English, Japanese, Korean, Spanish, Indonesian. Up to 300 characters."
},
"mask_url": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"title": "Mask URL",
"x-media": "image",
"maxItems": 5,
"description": "Optional mask image URL(s). To have a specific subject in the image speak, use 'Subject Detection' to get the corresponding mask image and pass it as input. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB."
},
"audio_url": {
"type": "string",
"title": "Audio URL",
"format": "uri",
"x-media": "audio",
"description": "Audio URL. Duration must be less than 60 seconds (recommended 15 seconds or less; exceeding this will cause quality degradation). Accepted file types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/mp4. Max file size: 10MB."
},
"image_url": {
"type": "string",
"title": "Image URL",
"format": "uri",
"x-media": "image",
"description": "Portrait image URL. Supports any aspect ratio with subjects including people, pets, anime, etc. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB."
},
"pe_fast_mode": {
"type": "boolean",
"title": "Pe fast mode",
"default": false,
"description": "Fast mode. Sacrifices some quality to speed up generation. Default value: `false`."
},
"output_resolution": {
"enum": [
"720",
"1080"
],
"type": "string",
"title": "Output resolution",
"default": "1080",
"description": "Output video resolution. `720`: 720P `1080`: 1080P (default) The output keeps the aspect ratio of the input image; 720 and 1080 are resolution tiers, not exact heights. The output is an MP4 as long as the audio."
}
}
}API request template
Replace placeholders and choose valid values from the input contract.
POST /api/v1/jobs
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json
{
"model": "omnihuman-1-5",
"input": {
"prompt": "<your prompt>"
}
}Completion, results and billing
Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.
Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.