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.
From 48 credits/call
Pricing
From 48 credits/call
| Rendering mode | Upscale factor: X1 / Not specified | Upscale factor: X2 | Upscale factor: X4 |
|---|---|---|---|
| Turbo | 48 credits/image | 192 credits/image | 240 credits/image |
| Standard / Not specified | 84 credits/image | 228 credits/image | 276 credits/image |
| Quality | 120 credits/image | 264 credits/image | 312 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
seed | integer | No | Random seed. Set for reproducible generation. | — |
prompt | string | Yes | 必填。透明背景图片生成提示,必须是非空字符串;禁止省略、传空字符串、数组、对象或占位符。 | — |
num_images | integer | No | Number of images to generate. | 1 |
aspect_ratio | enum (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_prompt | enum (AUTO | ON | OFF) | No | Determine if MagicPrompt should be used in generating the request or not. | — |
upscale_factor | enum (X1 | X2 | X4) | No | Upscale the initially generated image by the given factor. Upscale factors other than X1 will incur additional cost. | X1 |
negative_prompt | string | No | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. | — |
rendering_speed | enum (TURBO | DEFAULT | QUALITY) | No | The rendering speed to use. | DEFAULT |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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
Transparent-Background Asset Generation with AI AgentsUse an AI agent to generate transparent-background character sheets, icons and stickers directly — skip manual cut-outs, fall back to a background-removal tool when edges aren't clean, and batch out ready-to-layer PNG assets.AI Marketing Poster Campaign Workflow with AI AgentsTurn campaign posters into a pipeline: an AI agent generates the base image from your copy, cuts out subjects, swaps backgrounds and lays in text — producing a full set of posters in multiple sizes without a designer doing each one by hand.





