Hunyuan Image 3

Hunyuan Image 3

Playground

Try it on WavespeedAI!

HunyuanImage-3.0 is a groundbreaking native multimodal model that unifies multimodal understanding and generation within an autoregressive framework. Our text-to-image module achieves performance comparable to or surpassing leading closed-source models.

Features

Hunyuan Image 3.0

Harness the cutting-edge technology of Hunyuan Image 3.0 to transform your written ideas into compelling visual content. This advanced model ensures visuals that not only align with your narrative but also enhance its emotional and conceptual appeal.

What is Hunyuan Image 3.0?

Hunyuan Image 3.0 is a state-of-the-art text-to-image generation model. By simply providing a written prompt, you can create high-quality images that capture the essence of your story, resonate emotionally, and elevate your creative output.

Why it looks great

  • Prompt-driven generation: translates text descriptions into rich, detailed visuals.
  • Emotional resonance: enhances narrative impact by aligning visuals with tone and mood.
  • Flexible sizing: supports custom width and height up to large resolutions.
  • Style diversity: accommodates multiple visual aesthetics, from realism to artistic styles.
  • Reproducibility: use the seed parameter for consistent, repeatable results.
  • Format choice: export in JPEG and PNG for easy integration.

Limits and Performance

  • Max resolution per job: up to 2048 × 2048 pixels
  • Processing speed: ~5–10 seconds per image (varies by complexity and queue load)
  • Input prompt: supports detailed, multi-line descriptions

Pricing

Every image just $0.03!!!

How to Use

  1. Write a prompt describing the image you want.
  2. Adjust size (width & height).
  3. Set a seed for reproducibility.
  4. Choose output_format.
  5. Submit the job and download the generated image.

Pro tips for best quality

  • Be descriptive in your prompt — include mood, lighting, and style.
  • Portraits with clear attributes (face, pose, background) yield sharper results.
  • Fix the seed if you want consistent outputs across runs.
  • Use custom sizes for tailored content (e.g., vertical posters or wide banners).

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-image-3" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "1024*1024",
    "seed": -1,
    "enable_sync_mode": false,
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text prompt for image generation.
sizestringNo1024*1024256 ~ 1536 per dimensionThe size of the generated media in pixels (width*height).
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.
enable_sync_modebooleanNofalse-If set to true, the function will wait for the image to be generated and uploaded before returning the response. It allows you to get the image directly in the response. This property is only available through the API.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.