Ideogram V3
Text to image · Image editing
Starting price $0.05 / image
By Ideogram
Ideogram V2 makes posters, logos and graphics with legible lettering from a prompt, repaints a masked area of your image, and remixes an image into a new one.
ideogram/v2/editThis model has other modes with their own ids: ideogram/v2, ideogram/v2/remix.
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/edit",
"input": {
"prompt": "A neon sign reading \"OPEN\" in warm red light, mounted on the brick wall.",
"image_url": "https://example.com/input.png",
"mask_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/edit", "quote_id": "QUOTE_ID", "input": {"prompt":"A neon sign reading \"OPEN\" in warm red light, mounted on the brick wall.","image_url":"https://example.com/input.png","mask_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"| Name | Type | Description |
|---|---|---|
promptrequired | string | The prompt to fill the masked part of the image. |
image_urlrequired | string (image URL) | The image URL to generate an image from. Needs to match the dimensions of the mask. |
mask_urlrequired | string (image URL) | The mask URL to inpaint the image. Needs to match the dimensions of the input image. |
seed | integer | Seed for the random number generator |
style | string (enum) | The style of the generated image |
enable_prompt_expansion | boolean | Whether to expand the prompt with MagicPrompt functionality. |
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. |
A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.
"outputs": [
{ "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]The exact charge for your input comes from a quote. How charges settle
Fields marked * are required. Review the price before generating.
Ideogram V2 renders one image per run in eleven shapes from 3:1 to 1:3. A style setting picks general, realistic, design, 3D render or anime, or leaves it on auto; prompt expansion is on by default and adds detail to a short prompt; a negative prompt keeps things out.
The edit mode fills the white part of a mask you upload; the mask must have the same size as the image. The remix mode starts from your image, and its strength sets how much of the original survives.
Proofread every word and inspect letter spacing at the final display size.