GPT Image 2.5 transparent background: how to request a cutout by API
GPT Image 2.5 on Sume accepts background transparent. OpenAI says transparency needs png or webp output. The request, the catch, and when to use another route.

To get a transparent background from GPT Image 2.5 on Sume, send background: "transparent" and an output_format of png or webp. Sume lists background (auto, opaque, transparent) on the two 2.5 ids only, and OpenAI's guide says transparent backgrounds require png or webp; JPEG has no alpha channel.
Read from Sume's Image API docs and OpenAI's image generation guide on 2026-09-29.
What does the request look like?
Describe the subject alone, on its own, and let the model cut it out. The response's media_type should be image/png or image/webp.
curl -X POST "https://api.sume.com/v1/images" \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2.5",
"prompt": "a single ceramic mug, studio lighting, isolated subject",
"background": "transparent",
"output_format": "png",
"quality": "high"
}'What are the background values?
| `background` | Meaning | Models |
|---|---|---|
auto | Model decides | openai/gpt-image-2.5, -sunburst |
transparent | Alpha channel; use png or webp | openai/gpt-image-2.5, -sunburst |
opaque | Solid background | openai/gpt-image-2.5, -sunburst |
Check the edges before you ship
Look at the result on a dark and a light backdrop. Hair, glass and soft shadows are where a generated cutout can leave halos. For an existing photo, a dedicated background remover may be a better tool: see remove image background API.
What happens with ChatGPT Image 2?
background is not listed on openai/gpt-image-2, so it returns 400 unsupported_parameter. The docs point to Image 1.0 with transparency: true for transparent stills on other routes.
Sources
Related posts
More in Developers
- GPT Image 2.5 400 unsupported_parameter: fields each model accepts
A 400 unsupported_parameter from Sume's image API means the model does not list that field. Which GPT Image ids accept quality, mask_url and background.
- Grok 4.7 remote MCP tool: connect Sume to the xAI Responses API
xAI's remote MCP tool works with grok-4.7 on the Responses API. Point server_url at Sume's hosted MCP, restrict allowed_tools, and cap spend on the Sume side.
- HeyGen API avatar ID and voice ID: where to find them
In HeyGen's v3 API, avatar_id is a look id from GET /v3/avatars/looks, and voice_id comes from GET /v3/voices or the look's default voice.
- HeyGen API key: get one and make your first video
Generate a HeyGen API key in its API dashboard, send it as X-Api-Key to api.heygen.com, check it with GET /v3/users/me, then create a video.
Written by Sume