Ideogram color_palette parameter: brand colours in Sume prompts
Ideogram's API takes a color_palette parameter. The Sume image API has no palette field, so brand colours go in the prompt and a reference swatch image.

Ideogram's Generate 3.0 reference lists an optional color_palette parameter. The Sume image API has no such field: its request schema (see the Image API docs) carries model, prompt, n, resolution, aspect_ratio, quality, output_format, mask_url, background, input_references and a few routing and job fields. A request that sets a parameter the model does not list is rejected with 400 unsupported_parameter. Brand colours therefore travel in the prompt, backed by a swatch reference image.
What the vendor page says
From the Ideogram API reference, read on the date below.
| Parameter | What the page says |
|---|---|
| color_palette | Optional; typed as a palette given either by preset name or by members. |
| negative_prompt | Description of what to exclude; descriptions in the prompt take precedence. |
Do not send it
Copying an Ideogram body that includes color_palette into a Sume request will fail by design. Catalog descriptors are the definitive list, and allowed_passthrough_parameters is empty for every endpoint in v1, so provider.options cannot smuggle it through either.
Two substitutes that work
Combine both for the strongest pull:
- Name the colours in the prompt with hex codes and roles, for example "background #F4EDE4, accent #1F6F5C, text near-black".
- Send a plain swatch image as an
input_referencesentry and say "use only the colours in image 1". Models that listinput_referenceswith a max above 0 accept it.
Make the swatch from the brand file
A swatch needs no design tool. This script writes a PNG of equal colour bands; upload it anywhere public over HTTPS, then reference it.
from PIL import Image, ImageDraw
colors = ["#F4EDE4", "#1F6F5C", "#E2A33B", "#222222"]
w, h = 256, 256
img = Image.new("RGB", (w * len(colors), h))
d = ImageDraw.Draw(img)
for i, c in enumerate(colors):
d.rectangle([i * w, 0, (i + 1) * w, h], fill=c)
img.save("swatch.png")
print("saved swatch.png")Check the result
Colour adherence is a soft control. Sample the output with an eyedropper or a script, and if a colour drifts, shorten the palette to three. Because there is no seed, repeat the prompt once before blaming the wording.
Sources
Related posts
More in Developers
- Ideogram negative_prompt: what to send to the Sume image API instead
Ideogram has a negative_prompt parameter, but Sume's image API does not. Rewrite exclusions as positive instructions and check each result.
- Ideogram style_type REALISTIC, DESIGN, FICTION: the Sume equivalent
Ideogram 3.0 has a style_type with five values. Sume has none; get a realistic, design or fiction look through prompt wording and model choice.
- Verify a Sume job.completed webhook in Python (stdlib)
A stdlib Python verifier for Sume job webhooks: HMAC SHA-256 over timestamp.raw_body, five-minute tolerance, rotation-safe, and it refuses an empty secret.
- Image request timed out: do you pay for it on Sume?
Sume bills image jobs by outcome. A client timeout does not cancel the job, so a finished image can still bill. Use async mode and poll; do not resubmit.
Written by Sume