Model API

Ideogram V2

Reimagine existing images with Ideogram V2's remix feature. Create variations and adaptations while preserving core elements and adding new creative directions through prompt guidance.

Model id

Use this in every request

ideogram/v2/remix

This model has other modes with their own ids: ideogram/v2, ideogram/v2/edit.

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/v2/remix",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_url": "https://example.com/input.png"
  }
}'

# 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/v2/remix", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_url":"https://example.com/input.png"}}'

# 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/v2/remix
Name	Type	Description
`prompt`required	string	The prompt to remix the image with
`image_url`required	string (image URL)	The image URL to remix
`aspect_ratio`	string (enum)	The aspect ratio of the generated image Default: `1:1` One of: `10:16`, `16:10`, `9:16`, `16:9`, `4:3`, `3:4`, `1:1`, `1:3`, `3:1`, `3:2`, `2:3`
`strength`	number	Strength of the input image in the remix Default: `0.8`
`enable_prompt_expansion`	boolean	Whether to expand the prompt with MagicPrompt functionality. Default: `true`
`seed`	integer	Seed for the random number generator
`style`	string (enum)	The style of the generated image Default: `auto` One of: `auto`, `general`, `realistic`, `design`, `render_3D`, `anime`
`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`

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

1 image$0.13/ image

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