Recraft V4 Pro Text To Image
300 credits/call
ae_recraft_v4_pro_text_to_image
Create professional design and marketing images from text prompts, with custom dimensions, background color, and preferred color palette controls.
300 credits/call
Pricing
300 credits/call
| Condition | Charge |
|---|---|
| Each call | 300 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.colors | array | No | An array of preferable colors | — |
request_body.colors[].b | integer | No | Blue color value | 0 |
request_body.colors[].g | integer | No | Green color value | 0 |
request_body.colors[].r | integer | No | Red color value | 0 |
request_body.prompt | string | Yes | No parameter description. | — |
request_body.image_size | object | string | No | No parameter description. | square_hd |
request_body.image_size.width | integer | No | The width of the generated image. | 512 |
request_body.image_size.height | integer | No | The height of the generated image. | 512 |
request_body.background_color | object | unknown | No | The preferable background color of the generated images. | — |
request_body.background_color.b | integer | No | Blue color value | 0 |
request_body.background_color.g | integer | No | Green color value | 0 |
request_body.background_color.r | integer | No | Red color value | 0 |
request_body.enable_safety_checker | boolean | No | If 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-KeySubmit 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_recraft_v4_pro_text_to_image' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"background_color": {
"b": 247,
"g": 252,
"r": 255
},
"enable_safety_checker": true,
"image_size": "portrait_16_9",
"prompt": "Vertical mobile app splash screen for a couples nest app. Warm cream background transitioning softly to dusty rose pink at bottom. In the lower third: two tiny human silhouettes sitting together wrapped in one shared terracotta blanket, heads almost touching. Behind them one tiny cottage with a single glowing warm gold window. Four very small pale gold stars around the scene. Top 60 percent is completely empty soft gradient space for text overlay. Style: soft digital painting with gentle watercolor texture, editorial illustration like Kinfolk magazine covers, Between app launch screens, Julianna Brion art. INTIMATE and RESTRAINED, not cartoon, not flat vector, not kawaii. No text, no hearts as shapes, no flowers, no sparkles, no confetti, no emojis."
}
}
}'Response exampleresponse.json
{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "bdedf986-dd10-480c-b023-345d73d1f002"
}




