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.

Image
300 credits/call

Pricing

300 credits/call
ConditionCharge
Each call300 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.colorsarrayNoAn array of preferable colors—
request_body.colors[].bintegerNoBlue color value0
request_body.colors[].gintegerNoGreen color value0
request_body.colors[].rintegerNoRed color value0
request_body.promptstringYesNo parameter description.—
request_body.image_sizeobject | stringNoNo parameter description.square_hd
request_body.image_size.widthintegerNoThe width of the generated image.512
request_body.image_size.heightintegerNoThe height of the generated image.512
request_body.background_colorobject | unknownNoThe preferable background color of the generated images.—
request_body.background_color.bintegerNoBlue color value0
request_body.background_color.gintegerNoGreen color value0
request_body.background_color.rintegerNoRed color value0
request_body.enable_safety_checkerbooleanNoIf 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-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_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
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"
}