Skip to main content

Ideogram integration

Powered by Ideogram AI, this API expands images beyond their original boundaries with intelligent content generation that blends seamlessly with the original.
Ideogram Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries using Ideogram’s generative model. Specify how many pixels to add on each side (left, right, top, bottom) up to 2048 pixels, and optionally provide a text prompt to guide the generated content. If no prompt is provided, the model auto-generates one based on the image content. The API produces seamless expansions that maintain visual consistency with the original image, making it ideal for adapting images to different aspect ratios or adding creative space around subjects.

​
Key capabilities

  • Directional expansion: Independently control expansion on each edge (left, right, top, bottom) from 0 to 2048 pixels
  • Auto-prompt generation: Automatically generates a prompt from the image content when no prompt is provided
  • Prompt-guided generation: Optional text descriptions to guide what appears in expanded areas
  • Seamless blending: AI-generated content matches the style, lighting, and composition of the original image
  • Reproducible results: Optional seed parameter (0-2147483647) for consistent output across requests
  • Async processing: Webhook notifications or polling for task completion

​
Use cases

  • Social media adaptation: Convert landscape images to portrait format (or vice versa) for different platforms
  • Print production: Add bleed area or extend backgrounds for large-format printing
  • Design workflows: Create additional canvas space for text overlays, logos, or design elements
  • Photography enhancement: Extend cropped photos to recover lost composition
  • E-commerce: Expand product images to fit standardized dimensions
  • Marketing materials: Adapt hero images to various banner sizes and aspect ratios

​
Expand images with Ideogram

Submit an image with expansion parameters to extend it in any direction. The service returns a task ID for async polling or webhook notification.

POST /v1/ai/image-expand/ideogram

Create a new image expansion task

GET /v1/ai/image-expand/ideogram

List all Ideogram image expansion tasks

GET /v1/ai/image-expand/ideogram/{task-id}

Get task status and results by ID

​
Parameters

ParameterTypeRequiredDefaultDescription
imagestringYes-Base64-encoded image to expand
leftintegerYes-Pixels to expand on the left side (0-2048)
rightintegerYes-Pixels to expand on the right side (0-2048)
topintegerYes-Pixels to expand on the top side (0-2048)
bottomintegerYes-Pixels to expand on the bottom side (0-2048)
promptstringNoauto-generatedText prompt describing the desired expanded content. If not provided, the AI auto-generates a prompt based on the image.
seedintegerNorandomSeed for reproducibility (0-2147483647)
webhook_urlstringNo-URL for task completion notification

​
Frequently Asked Questions

Ideogram Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries. You submit a base64-encoded image with pixel expansion values for each edge (left, right, top, bottom), receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The API generates new content that seamlessly blends with the original image.
You can expand up to 2048 pixels on each edge (left, right, top, bottom) independently. All four directional parameters (left, right, top, bottom) are required. Set any edge to 0 if you do not want to expand in that direction.
If no prompt is provided, the Ideogram model automatically generates a prompt based on the image content. This auto-prompt feature analyzes the existing image and produces contextually appropriate content for the expanded areas.
The API accepts base64-encoded images. Common formats like JPEG, PNG, and WebP can be encoded and submitted. The output is returned as a downloadable image URL.
Yes. Use the seed parameter with the same value (0-2147483647) across requests to generate reproducible results. Combined with identical images, expansion values, and prompts, you will get consistent outputs.
Both APIs extend images beyond their original boundaries. Ideogram Image Expand features auto-prompt generation when no prompt is provided and requires all four directional parameters. Flux Pro Image Expand uses optional directional parameters with default values of 0. Choose based on your workflow preferences and output quality requirements.
Rate limits vary by subscription tier. See Rate Limits for current limits.
See the Pricing page for current rates and subscription options.

​
Best practices

  • Balanced expansion: For best results, avoid extreme asymmetric expansions; gradual extensions maintain better visual coherence
  • Prompt specificity: Use descriptive prompts when you need specific content in expanded areas (e.g., “sunset sky with orange clouds” instead of just “sky”)
  • Auto-prompt for natural results: Omit the prompt parameter to let the model analyze the image and generate contextually appropriate content
  • Image quality: Higher resolution input images produce better expansion results
  • Seed for consistency: Use the same seed value when you need reproducible results across multiple API calls
  • Production integration: Use webhooks instead of polling for scalable applications
  • Error handling: Implement retry logic with exponential backoff for 503 errors