POST/api/v1/imagine6 creditsSynchronousRequires image_url

Ideogram v3 Reframe

Provider · IdeogramType · ReframeModel ID · ideogram-v3-reframeUpstream ID · ideogram-reframe-v3

Ideogram v3 Reframe. Intelligently extends a square image to any aspect ratio by generating plausible content in the newly revealed areas. Perfect for repurposing square images into landscape or portrait formats.

Request Parameters

Parameter	Type	Required	Description
prompt	`string`	Required	The text prompt describing the image to generate.
model	`string`	Optional	Set to `ideogram-v3-reframe` to use this model.Default: `ideogram-v3-reframe`
image_url	`string`	Required	Source image URL. Required for this edit model — the request will fail without it.
aspect_ratio	`string`	Optional	Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: `1:1`
webhook_url	`string`	Optional	URL where we POST the completed task result.
webhook_secret	`string`	Optional	Sent as x-webhook-secret header in webhook delivery for verification.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/imagine \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v3-reframe",
    "prompt": "mountain landscape, same style and lighting",
    "image_url": "https://example.com/square-landscape.jpg",
    "aspect_ratio": "16:9"
  }'

Response

This model is synchronous — the response includes the finished image_url directly. No polling required.

200 OK

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "finished",
  "image_url": "https://cdn.example.com/output.png"
}

Tips

1Set `aspect_ratio` to specify the target format (e.g. 16:9 to expand a 1:1 image to widescreen).
2Keep the prompt minimal — it guides what is generated in the extended areas.

Quirks & Gotchas

Requires image_url — will fail without a source image.

Works best with square source images.