Available now

Ideogram 4.6

By Ideogram

Ideogram 4.6 edits an image from a text instruction, with optional masks, reference images, and precision controls.

Model ID
Maker
Ideogram

Model id

Use this in every request
ideogram/v4.6/edit

This model has other modes with their own ids: ideogram/v4.6.

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/v4.6/edit",
  "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/v4.6/edit", "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/v4.6/edit
NameTypeDescription
promptrequiredstring
The generation or editing prompt.
image_urlrequiredstring (image URL)
The image to edit. Upload it here so its size can be read.
reference_image_urlsarray of image URLs
Up to four reference images, or three when you use a mask.
mask_urlstring (image URL)
A mask the same size as the source image: black is edited, white is kept.
edit_precisionstring (enum)
regular uses Generate; high uses Precise Edit with unchanged-pixel restoration. Both always prepare structured edit instructions.

Default: regular

One of: regular, high

context_windowstring (enum)
High precision only. None edits the whole image; Auto fits the edit around the mask and keeps the original resolution.

Default: none

One of: none, auto

qualitystring (enum)
Quality tier for either edit precision. Defaults to medium.

Default: medium

One of: very_low, low, medium, high

image_sizestring (enum)
Auto keeps the size and shape of the source image. Edits without a mask at regular precision can also use a preset or a width and height of 256 to 4,096 pixels in multiples of 32, at most 6:1 either way. Sizes above 2048 x 2048 pixels in area are 4K; Very low quality stays at 2K or below.

Default: auto

One of: auto, square, square_hd, portrait_4_3, landscape_4_3, portrait_16_9, landscape_16_9

backgroundstring (enum)
Regular edits only. transparent returns an image with an alpha channel; opaque forces a solid background. Leave unset for the model default.

One of: transparent, opaque

num_imagesinteger
Number of images to generate.

Default: 1

seedinteger
Random seed. Omit to choose automatically.
sync_modeboolean
Return image data directly in the response.

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

  • Very low · 2K$0.02/ image
  • Low · 2K$0.05/ image
  • Medium · 2K$0.10/ image
  • High · 2K$0.35/ image
  • Low · 4K$0.10/ image
  • Medium · 4K$0.32/ image
  • High · 4K$0.96/ image

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

API docs