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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 24 credits/call |
Fixed fee of 24 credits per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.seed | integer | No | The random seed to use for the generation. -1 means a random seed will be used. | — |
request_body.size | string | No | The size of the generated media in pixels (width*height). | 1024*1024 |
request_body.image | string | Yes | No parameter description. | — |
request_body.prompt | string | Yes | The positive prompt for the generation. | — |
request_body.output_format | enum (jpeg | png | webp) | No | The format of the output image. | jpeg |
request_body.guidance_scale | number | No | The guidance scale to use for the generation. | 3.5 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
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"
}
}
}'{
"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.







