> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2.6 공식 릴레이: 유효하지 않은 출력 형식과 배경 조합은 무엇입니까?

> GPT Image 2.6 공식 릴레이(gpt-image-2.6-sunburst / gpt-image-2.6-flare)에서는 transparent + jpeg 조합만 400을 반환하며, gif는 1비트 투명도를 지원하고, svg에 배경을 적용하려면 opaque가 필요합니다.

> [!NOTE]
>
> 이 페이지는 두 **GPT Image 2.6 공식 릴레이** 모델에 적용됩니다. `gpt-image-2.6-sunburst`(정밀 작업)과 `gpt-image-2.6-flare`(빠른 반복 작업)입니다. GPT Image 2.5 / 2는 gif 또는 svg 출력을 지원하지 않으므로 이 규칙을 직접 적용하지 마십시오.

## 간단히 답변하면

유일한 하드 충돌은 `background: "transparent"`와 `output_format: "jpeg"`을 함께 사용할 수 없으며, 이 경우 400을 반환한다는 점입니다. 그 외 모든 조합은 작동하지만 투명도 처리 방식은 다릅니다.

| `background` | `png` | `jpeg` | `webp` | `gif` | `svg` |
| - | - | - | - | - | - |
| `transparent` | ✅ 완전한 알파 | ❌ 400 | ✅ 완전한 알파 | ✅ 1비트 투명도 | ✅ 배경 없음 |
| `opaque` | ✅ 불투명 | ✅ 불투명 | ✅ 불투명 | ✅ 불투명 | ✅ 흰색 배경 |
| `auto` | ✅ | ✅ | ✅ | ✅ | ✅ |

2026-11-12에 GPT Image 2.6 공식 릴레이에서 측정했습니다(`quality: "low"`, `n: 1`; 512×512, 2프레임 GIF, `svg.model: "gpt-4.1-mini"`이 포함된 SVG). 전체 매트릭스는 `gpt-image-2.6-sunburst`에서 측정했으며, `jpeg + transparent`, `gif + transparent`, `svg + opaque`은 `gpt-image-2.6-flare`에서 동일한 결과로 재확인했습니다.

## JPEG에서만 400 오류가 발생합니다

JPEG에는 알파 채널이 없으므로 `background: "transparent"`가 실패하고 다음 오류가 반환됩니다.

```text theme={null}
Transparent background is not supported for JPEG output format
```

`/v1/images/generations`와 `/v1/images/edits` 모두에 해당합니다. `png` / `webp`로 전환하거나, 애니메이션의 경우 `gif`을 사용하세요. `opaque`와 `auto`은 JPEG에서도 잘 작동합니다.

> [!WARNING]
>
> 편집 엔드포인트에서 이 400 오류가 반환되기까지 테스트에서 약 62초가 걸렸습니다(텍스트-이미지 변환에서는 약 19초). 요청이 느려 보인다는 이유만으로 재시도하지 마세요.

## GIF는 투명도를 지원하지만 알파 채널은 1비트만 지원합니다

`output_format: "gif"` + `background: "transparent"`은 2.6에서 텍스트-이미지 생성과 이미지 편집 모두에 사용할 수 있습니다. 테스트에서는 프레임의 46%\~60%가 투명 픽셀이었으며, `opaque`에서는 0%였습니다.

GIF 투명도는 팔레트 기반입니다. 각 픽셀은 완전히 투명하거나 완전히 불투명하며, 부드러운 알파 가장자리는 지원하지 않습니다. 가장자리 품질이 중요한 경우 `png` / `webp`를 사용하십시오. 이 내용은 GIF 출력을 지원하는 2.6에만 적용되며, 2.5 및 이전 버전은 GIF 출력을 지원하지 않습니다.

## SVG에는 알파 채널이 없으며, `opaque`는 배경을 추가합니다

SVG는 알파 채널이 없는 벡터 형식이며, 기본적으로 배경은 투명합니다:

* `transparent`: 배경 사각형을 작성하지 않습니다.
* `opaque`: `<rect width="1024" height="1024" fill="#fff" />`와 같이 캔버스 전체를 덮는 흰색 사각형을 추가합니다.
* `auto`: 두 차례의 테스트 모두에서 `auto`는 배경을 작성하지 않았으므로, 이를 `opaque`와 동일하게 취급하지 마십시오. 흰색 배경이 필요하면 `opaque`를 명시적으로 전달하십시오.

> [!NOTE]
>
> `output_format: "svg"`는 텍스트-이미지 변환 엔드포인트에서만 지원되며, `n: 1` 및 `svg.model`가 필요합니다. 생성 모델이 최종 배경 마크업을 결정하므로, `svg.model`를 변경한 후에는 실제 파일을 다시 확인하십시오.

## `auto`은 `opaque`로 고정되지 않습니다

생략하면 `background`은 기본적으로 `auto`로 설정됩니다. `auto`은 항상 단색 배경을 생성하는 대신 프롬프트를 따릅니다.

* 흰색 단색 배경을 요청하는 프롬프트에서는 `png` / `jpeg` / `gif`이 `opaque`을 반환했으며 알파 채널은 없었습니다.
* 배경 없이 피사체만 분리해 달라고 요청하는 프롬프트에서는 `png` / `webp` / `gif` / `svg`가 `transparent`을 반환했습니다. 처음 세 항목에는 실제로 투명 픽셀이 있었습니다.
* `jpeg`을 사용하면 `auto`은 `opaque`으로 강제 설정되며 오류가 발생하지 않습니다.

결과를 일관되게 얻으려면 `auto`에 의존하지 말고 `transparent` 또는 `opaque`을 명시적으로 전달하세요.

## 서로 관련된 두 가지 형식 제약

* `output_compression`은 `jpeg` / `webp`에만 적용됩니다.
* `frame_count` / `frame_duration_ms`는 `gif` 전용입니다. PNG, JPEG, WebP 또는 SVG에는 지정하지 마세요.

## 관련 문서

> [card] [GPT Image 2.6 기능](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2/gpt-image-2-6.md)
>
> SVG, GIF, `complexity` 및 마크업 기반 편집으로 실제 결과를 얻을 수 있습니다.

> [card] [투명한 이미지를 생성하는 방법](https://docs.apiyi.com/ko/faq/image-transparent-background.md)
>
> 투명한 배경을 위한 매개변수 형식, prompt 요구 사항 및 일반적인 오류입니다.

> [card] [텍스트-이미지 API 레퍼런스](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2/text-to-image.md)
>
> `/v1/images/generations`의 모든 필드입니다.

> [card] [이미지 편집 API 레퍼런스](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2/image-edit.md)
>
> `/v1/images/edits` 및 다중 이미지 편집입니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.