Model API

Ideogram

Extend existing images with Ideogram V3's reframe feature. Create expanded versions and adaptations while preserving main image and adding new creative directions through prompt guidance.

Model id

Use this in every request

ideogram/v3/reframe

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3/reframe",
  "input": {
    "image_url": "https://example.com/input.png",
    "image_size": "square_hd"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "ideogram/v3/reframe", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png","image_size":"square_hd"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for ideogram/v3/reframe
Name	Type	Description
`image_urls`	array of image URLs	A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format
`rendering_speed`	string (enum)	The rendering speed to use. Default: `BALANCED` One of: `TURBO`, `BALANCED`, `QUALITY`
`color_palette`	object	A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members)
`style_codes`	array of strings	A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style
`style`	string (enum)	The style type to generate with. Cannot be used with style_codes. One of: `AUTO`, `GENERAL`, `REALISTIC`, `DESIGN`
`num_images`	integer	Number of images to generate. Default: `1`
`seed`	integer	Seed for the random number generator
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`
`style_preset`	string (enum)	Style preset for generation. The chosen style preset will guide the generation.
`image_url`required	string (image URL)	The image URL to reframe
`image_size`required	string (enum)	The resolution for the reframed output image One of: `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

Turbo · up to$0.05/ image
Balanced · up to$0.10/ image
Quality · up to$0.15/ image

The exact charge for your input comes from a quote. How charges settle