tencent/hunyuan-custom
Hunyuan Custom by Tencent - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
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/runtencent/hunyuan-customInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | URL of the image input. |
prompt | string | Required | Text prompt for video generation (max 500 characters). |
resolution | string | Optional | The resolution of the video to generate. 720p generations cost 1.5x more than 480p generations. · Options: 512p, 720p · Default: "512p" 512p720p |
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": "tencent/hunyuan-custom",
"image": "https://static.sandbase.ai/examples/tencent/hunyuan-custom/input_image_0.png",
"prompt": "Realistic, High-quality. A woman is playing a violin.",
"resolution": "512p"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Hunyuan Custom
Hunyuan Custom occupies a clearly bounded position in a video production pipeline under the route tencent/hunyuan-custom. 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 Hunyuan Custom should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final hunyuan custom 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 tencent/hunyuan-custom.
Highlights
- Distinct output behavior. For Hunyuan Custom, for Hunyuan Custom, pair a still picture with text describing the intended video In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom 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.
- Creative control. For Hunyuan Custom, for Hunyuan Custom, select ratios from 21:9 through 9:16 In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom 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.
- Workflow fit. For Hunyuan Custom, for Hunyuan Custom, request 512p or 720p In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom workflow with resolution as a relevant request control; the resolution control exposes the corresponding choice in this route; the resolution control exposes the corresponding choice in this route.
- Production detail. For Hunyuan Custom, for Hunyuan Custom, keep video direction within 500 characters In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom 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 |
|---|---|
| resolution=512p | $0.8 |
| resolution=720p | $2.4 |
When to Use
| Scenario | Why this model fits |
|---|---|
| Choose Hunyuan Custom | Use it when the required deliverable is specifically the video result documented for tencent/hunyuan-custom. |
| Match the source material | Select this route when your inputs naturally map to image, prompt, resolution, aspect_ratio. |
| Use its distinguishing capability | For Hunyuan Custom, pair a still picture with text describing the intended video In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom workflow with image as a relevant request control; the image control exposes the corresponding choice in this route |
| Plan repeatable production | For Hunyuan Custom, select ratios from 21:9 through 9:16 In Hunyuan Custom, this capability is applied through the exact tencent/hunyuan-custom workflow with prompt as a relevant request control; the prompt 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 Hunyuan Custom jobs. |
Prompt Guide
Build the request around the exact tencent/hunyuan-custom 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/tencent/hunyuan-custom/input_image_0.png",
"prompt": "Realistic, High-quality. A woman is playing a violin.",
"resolution": "512p",
"aspect_ratio": "21:9"
}
Technical Specs
| Specification | Value |
|---|---|
| Model ID | tencent/hunyuan-custom |
| Execution mode | async |
| Required inputs | prompt, image |
| Request fields | image (string, required); prompt (string, required); resolution (string, optional, options: 512p / 720p); 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) |