Phota

From 108 credits/call
ae_phota

Create up to four photorealistic images from a text prompt, with optional profile references, framing, high resolution, and file format choices.

Image
From 108 credits/call

Pricing

From 108 credits/call
ResolutionCharge
1K / Not specified108 credits/image
4K216 credits/image

An omitted image count is charged as one image. Starting price applies to Resolution: 1K.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringYesText description of the desired image. In case you wish to use specific profiles, refer to them as [[profile_id_1]], [[profile_id_2]], etc.—
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.num_imagesintegerNoNumber of images to generate.1
request_body.resolutionenum (1K | 4K)NoResolution of the generated image.1K
request_body.aspect_ratioenum (auto | 1:1 | 16:9 | 4:3 | 3:4 | 9:16)NoAspect ratio of the generated image.auto
request_body.output_formatenum (jpeg | png | webp)NoThe format of the generated image.jpeg

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_phota' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "aspect_ratio": "3:4",
      "num_images": 1,
      "output_format": "jpeg",
      "prompt": "Cinematic photorealistic portrait of a young East Asian woman, mid-twenties, black sleeveless evening dress, dark hair in a low bun, minimal jewelry, standing on a night city street with wet asphalt reflections, warm red and amber neon bokeh behind her, 35mm film look, shallow depth of field",
      "resolution": "1K"
    }
  }
}'
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": "8050bd30-0747-4ecf-83bb-15e3ec425ffb"
}