Kling Image V3 Text To Image

From 34 credits/call
ae_kling_image_v3_text_to_image

Create one or more high-resolution images from a text prompt, with optional aspect ratio, negative prompt, and reference images for character or object consistency.

Image
From 34 credits/call

Pricing

From 34 credits/call
ConditionCharge
Per image34 credits/image

Charges depend on image count.

An omitted image count is charged as one image.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringYesText prompt for image generation. Max 2500 characters.—
request_body.elementsarray | unknownNoOptional: Elements (characters/objects) to include in the image for face control. Each element can have a frontal image and optionally reference images.—
request_body.elements[].frontal_image_urlstring | unknownNoThe frontal image of the element (main view). Optional.—
request_body.elements[].reference_image_urlsarray | unknownNoAdditional reference images from different angles. 0-3 images supported. Optional.—
request_body.sync_modebooleanNoIf `True`, the media will be returned as a data URI.false
request_body.num_imagesintegerNoNumber of images to generate (1-9).1
request_body.resolutionenum (1K | 2K)NoImage generation resolution. 1K: standard, 2K: high-res.1K
request_body.aspect_ratioenum (16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 3:2 | 2:3 | 21:9)NoAspect ratio of generated images.16:9
request_body.output_formatenum (jpeg | png | webp)NoThe format of the generated image.png
request_body.negative_promptstring | unknownNoNegative text prompt. It is recommended to supplement negative prompt information through negative sentences directly within positive prompts.—

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_kling_image_v3_text_to_image' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "aspect_ratio": "16:9",
      "num_images": 1,
      "output_format": "jpeg",
      "prompt": "Clean modern medical hospital background, soft cool blue and white gradient, abstract subtle medical symbols faintly visible in the distance: EKG heartbeat line, DNA helix, microscope silhouette, soft bokeh light circles, premium professional feel, airy and sterile, no people, no text, high resolution, minimal composition, hospital brand aesthetic",
      "resolution": "2K"
    }
  }
}'
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": "7aed783c-cd5e-4292-9cc4-20201019f743"
}