Pulid

24 credits/call
ae_pulid

ae_pulid — Generate portraits or other images from a reference image and a text prompt using WaveSpeed FLUX-PuLID. The reference guides the subject's likeness; an exact match is not guaranteed. Provide both the reference image and prompt. You can optionally set image size, guidance scale, seed, and output format (JPEG, PNG, or WebP). Generation runs asynchronously, and the result is retrieved for the submitted task.

Image
24 credits/call

Pricing

24 credits/call
ConditionCharge
Each call24 credits/call

Fixed fee of 24 credits per call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedintegerNoThe random seed to use for the generation. -1 means a random seed will be used.—
request_body.sizestringNoThe size of the generated media in pixels (width*height).1024*1024
request_body.imagestringYesNo parameter description.—
request_body.promptstringYesThe positive prompt for the generation.—
request_body.output_formatenum (jpeg | png | webp)NoThe format of the output image.jpeg
request_body.guidance_scalenumberNoThe guidance scale to use for the generation.3.5

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_pulid' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "guidance_scale": 3.5,
      "image": "REPLACE_WITH_BASE64_DATA",
      "output_format": "png",
      "prompt": "anime character front view, full body, standing upright, legs slightly apart, arms raised 45 degrees to the sides, blue-purple gradient long hair, purple eyes, black nails, black lace strap babydoll dress with purple accents, game character portrait sheet style, pure white background, high quality, detailed, official game artwork style",
      "size": "768*1024"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "d44deee7-8c5b-402c-a36d-e96d6f590f86"
}

Base64 content uses REPLACE_WITH_BASE64_DATA. Replace it with your actual data before running.

This example shows part of the response. Copied content is valid JSON.