Hunyuan Image 3 Instruct Gpu

From 108.00 credits
ae_hunyuan_image_3_instruct_gpu

Create images from text prompts with selectable size, format, and number of results.

Image
From 108.00 credits

Pricing

108.00 AE credits per MP. Charge on total returned-image MP, rounded to two decimal places; non-empty successful output has a minimum charge of 1 MP per call. One MP is 1024 by 1024 pixels.

From 108.00 credits

Starting price applies to successful image results within the minimum 1-MP tier.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNoRandom seed for reproducible results. If None, a random seed is used.—
request_body.promptstringYesThe text prompt to generate an image from.—
request_body.sync_modebooleanNoIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.false
request_body.image_sizeobject | stringNoThe desired size of the generated image. If auto, image size will be determined by the model.auto
request_body.image_size.widthintegerNoThe width of the generated image.512
request_body.image_size.heightintegerNoThe height of the generated image.512
request_body.num_imagesintegerNoThe number of images to generate.1
request_body.output_formatenum (jpeg | png)NoThe format of the generated image.png
request_body.guidance_scalenumberNoControls how much the model adheres to the prompt. Higher values mean stricter adherence.3.5
request_body.enable_safety_checkerbooleanNoIf set to true, the safety checker will be enabled.true

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_hunyuan_image_3_instruct_gpu' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "enable_safety_checker": true,
      "guidance_scale": 4,
      "image_size": "square_hd",
      "num_images": 1,
      "output_format": "png",
      "prompt": "Product photography of a solid oak sideboard cabinet, 160cm wide, two flat doors with a slim shadow gap, thin 25mm top with a slight overhang, four short tapered legs, warm natural oak grain, matte hard-wax oil finish, three-quarter front view from slightly above, isolated on a pure white seamless studio background, soft even studio light, subtle contact shadow, no props, no text, centered, entire object in frame"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "edea6ef0-c9c7-4210-bcb1-d260949eb041"
}