Ideogram AI Post Generate Image V 3 Transparent

From 48 credits/call
ae_ideogramai_post_generate_image_v_3_transparent

Create images with transparent backgrounds using Ideogram, ideal for logos, icons, stickers, and design assets. Provide a non-empty prompt; you can also choose the aspect ratio, rendering speed, number of images, and optional upscaling.

ImageUpscaling
From 48 credits/call

Pricing

From 48 credits/call
Rendering modeUpscale factor: X1 / Not specifiedUpscale factor: X2Upscale factor: X4
Turbo48 credits/image192 credits/image240 credits/image
Standard / Not specified84 credits/image228 credits/image276 credits/image
Quality120 credits/image264 credits/image312 credits/image

An omitted image count is charged as one image. Starting price applies to Rendering mode: Turbo, Upscale factor: X1.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
seedintegerNoRandom seed. Set for reproducible generation.—
promptstringYes必填。透明背景图片生成提示,必须是非空字符串;禁止省略、传空字符串、数组、对象或占位符。—
num_imagesintegerNoNumber of images to generate.1
aspect_ratioenum (1x3 | 3x1 | 1x2 | 2x1 | 9x16 | 16x9 | 10x16 | 16x10 | 2x3 | 3x2 | 3x4 | 4x3 | 4x5 | 5x4 | 1x1)No可选。必须严格使用 schema 枚举中的宽高比字符串,分隔符必须是小写 x,不是冒号。示例:16:9 必须写成 "16x9",4:3 必须写成 "4x3",9:16 必须写成 "9x16"。禁止传 "16:9"、"4:3"、自然语言或不在 enum 内的值。—
magic_promptenum (AUTO | ON | OFF)NoDetermine if MagicPrompt should be used in generating the request or not.—
upscale_factorenum (X1 | X2 | X4)NoUpscale the initially generated image by the given factor. Upscale factors other than X1 will incur additional cost.X1
negative_promptstringNoDescription of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. —
rendering_speedenum (TURBO | DEFAULT | QUALITY)NoThe rendering speed to use.DEFAULT

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_ideogramai_post_generate_image_v_3_transparent' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "aspect_ratio": "3x4",
    "magic_prompt": "OFF",
    "negative_prompt": "background, car interior, steering wheel, dashboard, text, watermark, logo, realistic photo, extra limbs, deformed hands",
    "num_images": 1,
    "prompt": "flat vector illustration game sprite, transparent background, young asian woman upper body seen from behind and slightly to the right, three-quarter back view, her head turned so her side profile and one eye are visible, long dark brown hair in a low ponytail, light blue-grey knit sweater, small coral scarf at the neck, her right arm reaching forward out of the frame as if holding a steering wheel, clean minimal flat shapes, soft pastel palette, cute and pretty, no background, no car, no steering wheel, no text",
    "rendering_speed": "DEFAULT"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "created": "2026-11-11T04:22:56.780071+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "flat vector illustration game sprite, transparent background, young asian woman upper body seen from behind and slightly to the right, three-quarter back view, her head turned so her side profile and one eye are visible, long dark brown hair in a low ponyt",
      "resolution": "864x1152",
      "seed": 279166659,
      "style_type": "CUSTOM"
    }
  ],
  "notice": "This endpoint is an older version. Use POST /v2/image/generate/ideogram-3-transparent instead: https://developer.ideogram.ai/v2/api-reference/images/generate/ideogram-3-transparent. Docs index for agents, with every current endpoint: https://developer.ideo"
}

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

Guides using this tool

See how this tool fits into real workflows