POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 const axios = require('axios'); const fs = require('fs'); const path = require('path'); async function toB64(imgPath) { const data = fs.readFileSync(path.resolve(imgPath)); return Buffer.from(data).toString('base64'); } const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/ideogram-v4-remix"; const data = { "prompt": "Turn this into an elegant art-deco perfume advertising poster. Keep the frosted-glass bottle with gold cap centered and untouched. At the top, one single crisp gold serif headline on ONE line reading \"AURELIA\", and directly beneath it a smaller line reading \"MAISON DE PARFUM\". Near the bottom a small centered tagline reading \"PARIS\". Thin decorative botanical line-art frame around the edges. Warm cream and champagne-gold palette, soft studio glow, refined luxury magazine layout, sharp legible typography, no repeated or duplicated words.", "image": "toB64('https://segmind-resources.s3.amazonaws.com/input/ideogram-v4-remix-example-input.jpg')", "image_weight": 45, "rendering_speed": "DEFAULT", "resolution": "2048x2048", "enable_copyright_detection": false }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Transformation instruction; wrap literal words in double quotes. Name a typeface for cleaner headlines.


imageimage *

Source JPEG, PNG, or WebP up to 10MB, as URL or base64. Use a clear, well-lit subject.


image_weightint ( default: 45 )

Source influence from 1 to 100. Use 40-50 for poster restyles, 70+ to stay close to the original.


rendering_speedenum:str ( default: DEFAULT ) Affects Pricing

Speed and price tier: TURBO, DEFAULT, or QUALITY. Pick QUALITY for final art, TURBO for quick drafts.

Allowed values:


resolutionenum:str ( default: 2048x2048 )

Native 2K output size and aspect ratio. Use 2048x2048 square, or tall/wide ratios for posters and banners.

Allowed values:


enable_copyright_detectionbool ( default: 1 )

Toggles post-generation copyright likeness and logo checks. Enable for commercial or brand-safe work.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Ideogram V4 Remix — Image-to-Image Transformation

What is Ideogram V4 Remix?

Ideogram V4 Remix turns an existing image into a new one from a text instruction, keeping the original composition while restyling it. It is the remix (image-to-image) mode of Ideogram 4.0, Ideogram AI's open-weight foundation model built around design-grade output. You pass a source image and a prompt; an image_weight control decides how much of the original is preserved, so the same photo can become a subtle retouch or a fully reimagined poster.

What sets it apart is text. Ideogram has led in-image typography since its first release, and 4.0 renders headlines, taglines, packaging copy, and signage that actually say the right words at native 2K resolution. That makes Remix a fast path from a plain product shot or sketch to a finished, on-brand design.

Key Features

  • Prompt-driven restyle: transform any JPEG, PNG, or WebP without starting from scratch.
  • Image weight control: dial similarity to the source from 1 (highly varied) to 100 (close match).
  • Best-in-class text rendering: legible, structurally integrated type, not fragile overlays.
  • Native 2K output: photoreal detail across square, portrait, and landscape aspect ratios.
  • Adjustable rendering speed: TURBO, DEFAULT, or QUALITY tiers to trade speed for fidelity.

Best Use Cases

Remix shines on design and branding work: campaign and movie posters, product mockups, packaging concepts, social media graphics with hero copy, book and album covers, logos, and signage. In testing, a plain studio product photo restyled cleanly into a luxury advertising poster with a crisp headline, sub-line, tagline, and decorative border — the source structure preserved while the styling and typography were rebuilt. It is equally strong for style transfer, turning photographs into painterly or illustrated versions while keeping the subject recognizable.

Prompt Tips and Output Quality

Wrap literal text in double quotes (e.g. "AURELIA") and name a specific typeface for cleaner results. Keep each label on its own line and add "no repeated words" to avoid duplicated headlines. Use image_weight 40–50 to give the model room to compose a poster while keeping the subject; push to 70+ for subtle restyles that hug the original. QUALITY renders the sharpest final art; TURBO is best for quick drafts. Output is consistently crisp and photorealistic, though very long text strings and photoreal human faces remain the hardest cases.

FAQs

What does image weight do in Ideogram V4 Remix? It controls how strongly the source image is preserved. Low values follow your prompt for bigger changes; high values keep the original composition and only restyle details.

Can it render readable text in images? Yes. Text rendering is Ideogram's signature strength — headlines, taglines, and captions come out legible and correctly spelled when you quote the exact words.

What input formats and sizes are supported? JPEG, PNG, or WebP up to 10MB, supplied as a public URL or base64 string.

What resolutions can it output? Native 2K in a range of aspect ratios, from 2048x2048 square to tall and wide formats for posters and banners.

How is Remix different from text-to-image? Remix starts from an existing image and transforms it, preserving layout and subject, whereas text-to-image builds an image from the prompt alone.

Which rendering speed should I choose? Use QUALITY for finished, client-ready art, DEFAULT as the balanced everyday option, and TURBO when iterating quickly on ideas.