GPT-Image-2.6-All 이미지 생성 및 편집

​

개요

• 가격: 이미지당 $0.025, 호출당 과금됩니다. 2K/4K도 가격은 동일합니다.
• 속도: 약 10–46초(1K는 10–22초, 2K는 12–24초, 4K는 15–42초이며, 꼬리 지연 시간은 60초를 넘을 수 있습니다)
• 품질: 긴 변이 512–1536이면 네이티브입니다. ChatGPT 웹 품질과 지문을 가장 잘 제어할 수 있으며, 2K/4K는 초해상도로, 대형 캔버스 크기 문제를 해결하지만 1.5K보다 세부 묘사가 더 뛰어난 것은 아닐 수 있습니다.
• 형식: PNG / JPEG / GIF / SVG, 투명 배경 및 24시간 URL을 지원합니다. GIF / SVG는 이 라우트에서 네이티브로 지원되며 2.5-all에서는 사용할 수 없습니다.
• 중국어: 중국어 prompt를 네이티브로 지원하며 포스터, 안내 표지판, 인포그래픽의 텍스트 렌더링이 뛰어납니다.

​

빠른 시작

​

텍스트로 이미지 생성 (curl)

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A beige paper-textured autumn reading club poster, vertical Chinese title in the center, hand-drawn maple leaf at the bottom right",
    "size": "1536x1024",
    "response_format": "b64_json"
  }'

​

이미지 편집 (Python, 멀티파트)

import base64
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
    timeout=600,
)

with open("input.png", "rb") as f:
    result = client.images.edit(
        model="gpt-image-2.6-all",
        image=f,
        prompt="Replace the background with light gray, keep the subject and text",
        size="1536x1024",
    )

image_bytes = base64.b64decode(result.data[0].b64_json)
with open("edited.png", "wb") as f:
    f.write(image_bytes)

​

기능

​

크기

​

네이티브 범위(≤1536, ChatGPT 웹 네이티브)

• 16/64 정렬은 필요하지 않습니다. 1537, 1600x900 및 1920x1080는 네이티브 경로에서 거부됩니다.
• size=auto은 상위 단계에서 결정됩니다. 1312x1199, 1402x1122 및 1448x1086이 확인되었지만, 고정된 값은 보장되지 않습니다.
• 네이티브 경로에서는 응답의 size이 실제 출력 크기와 같습니다.

​

초고해상도 범위(2K / 4K, 대형 캔버스 호환성)

​

크기 선택

• 최상의 ChatGPT 네이티브 느낌 / 안정적인 품질: size을 1536 이하로 유지하십시오. 약 1.5K가 이상적입니다. ChatGPT 특유의 특징이 있는 가장 제어하기 쉬운 등급입니다.
• 2K 대형 캔버스 호환성: 2048x2048, 2048x1152, 2048x1536을 사용하십시오. 일반적인 크기는 정확하지만 1.5K보다 더 세밀한 결과를 기대하지 마십시오.
• 4K 가로형: 3840x2160을 사용하십시오. 일반적으로 3840x2160이 반환되며, 간헐적으로 4096x2731이 반환됩니다. 실제 픽셀을 확인하십시오.
• 대형 정사각형: 상한은 2880이며, 4096x4096는 2880x2880으로 반환됩니다.
• 4:1 배너: 지원되지 않습니다. 4096x1024은 400을 반환합니다.

​

형식

• 투명 배경: background=transparent + PNG. 2K에서는 결과가 약 40%의 완전 투명 픽셀을 포함하는 RGBA입니다. 4K 투명 출력은 size을 따르지 않으며, 크기는 보장되지 않습니다.
• URL: response_format=url은 Default 그룹에서 작동하며, Image2_OSS 그룹은 필요하지 않습니다. 링크는 24시간 유효한 서명된 URL입니다.
• WebP 미지원: 오류는 output_format 'webp' is not supported; use png, jpeg, gif or svg입니다.

​

GIF

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A looping animation of a yellow doll frowning, puffing its cheeks and stomping, pure white background, seamless loop",
    "size": "2048x2048",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 150
  }'

• output_format=gif은 필수입니다. 프롬프트에서 루프만 요청하고 형식을 지정하지 않으면 호환성 계층이 PNG를 예상하므로 요청이 502 오류로 실패합니다 image 1 is gif, png was asked for.
• frame_count / frame_duration_ms는 정확히 적용됩니다. 8프레임 / 150ms, 4프레임 / 300ms, 6프레임 / 120ms 모두 요청과 일치했습니다.
• size는 출력 크기를 결정하지 않습니다. 1K 결과에는 384x512, 507x506, 619x623이 포함되었고, 2K 결과는 327x585, 4K 결과는 621x621이었습니다. 프레임 수와 지속 시간만 보장됩니다.
• GIF 크기를 고정하려면 생성 후 클라이언트에서 크기를 조정하거나 자르십시오.

​

SVG

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A flat rocket icon, exactly three colors, no text",
    "size": "2048x2048",
    "output_format": "svg"
  }'

• 진정한 벡터: 응답은 비트맵이 아닌 <svg> 텍스트입니다. 2048², 3840x2160, 4096², 6144² 및 8192² 모두 통과했습니다.
• viewBox는 size를 따릅니다: 2048x2048은 viewBox="0 0 2048 2048"을 제공하고, 3840x2160은 viewBox="0 0 3840 2160"을 제공합니다.
• svg 객체가 필요하지 않습니다: output_format=svg이면 충분합니다. 공식 경로 또는 일부 SDK는 "svg": {"model": "..."}을 추가하지만, 2.6-all은 해당 필드를 허용하지만 무시합니다. 오류가 발생하지 않으며 결과도 변경되지 않으므로 이에 의존하지 마십시오.
• 출력에는 <script> 또는 삽입된 래스터 이미지가 포함되지 않습니다.

​

이미지 편집

• 엔드포인트: POST /v1/images/edits, multipart/form-data.
• 단일 이미지 / 마스크 / 여러 참조 이미지를 사용할 수 있습니다. 마스크는 참조 이미지로 취급됩니다. 편집 결과가 마스크 안에만 유지되는 것은 보장되지 않으므로, 변경할 부분과 유지할 부분을 설명하십시오.
• 명시적인 size는 정확히 적용됩니다. 2K/4K도 포함됩니다(2048x2048 및 3840x2160 모두 확인됨).
• size이 없거나 auto인 경우, 입력의 종횡비를 유지하면서 출력 크기가 약 1.57 MP로 정규화됩니다. 원본 픽셀 크기는 보장되지 않습니다.
• 참조 이미지는 두 개까지 실제로 사용할 수 있습니다. 그 이상은 클라이언트에서 합성하거나 여러 단계로 편집하십시오.

​

n 및 응답

• n은 1~10을 지원하며 이미지당 과금됩니다. 2K에서 n=2는 2048x2048 이미지 두 장을 반환했고, n=3는 usage.image_count=3 및 output_image_tokens=8160(3 × 2720)와 함께 이미지 세 장을 반환했습니다. 이미지당 $0.025이므로 총 $0.075이며, 최종 청구액은 청구 내역에 표시된 금액입니다.
• 기본값은 b64_json입니다. response_format=url은 url만 반환하며, 둘 다 반환하지는 않습니다.
• 일반적인 응답 필드: created, data[], usage. 2K/4K에서는 size 필드가 누락될 수 있으며, 1K에서는 일반적으로 해당 필드가 그대로 반환됩니다.
• URL은 24시간 동안 유효한 서명이 적용됩니다. 만료된 후에는 새로 생성하십시오.

​

시간 초과 및 동시 실행 수

• 클라이언트 시간 초과를 600초로 설정합니다: 1K는 약 1022초, 2K는 1224초, 4K는 15~42초가 걸리며, 꼬리 지연 시간은 60초를 초과할 수 있습니다. 리버스 프록시, 서버리스 제한, 큐 소비자 설정도 여유 있게 조정합니다.
• 동시 실행 수: 1K에서는 12×2, 16×1, 8×1536 모두 429 오류 없이 통과했습니다. 2K/4K는 부하 테스트를 거치지 않았으므로 동시 요청 4~8개로 시작하고 꼬리 지연 시간을 확인합니다.
• 과금은 동기식입니다: 요청을 보내면 과금되며, 클라이언트 연결이 끊겨도 환불되지 않고 결과도 보존되지 않습니다.

​

제한 사항

• 2K/4K는 대형 캔버스 호환성을 위한 초해상도입니다. 네이티브 픽셀이 아니며, 1536 네이티브 티어보다 더 많은 디테일을 담는다고 보장하지 않습니다. 안정적인 품질을 위해 1536 이하로 유지하십시오.
• 2K/4K는 대체 경로에 의존합니다. 요청은 먼저 네이티브 경로로 전달되며, 크기가 범위를 벗어나면 초해상도 경로로 전환됩니다. 대체 경로를 사용할 수 없는 경우 API가 400 wide_fallback_required을 반환할 수 있으므로 다시 시도하거나 1536 이하로 유지하십시오.
• GIF 크기는 보장되지 않습니다. 1K, 2K, 4K 모두 작은 이미지를 반환할 수 있습니다. 보장되는 항목은 프레임 수와 재생 시간뿐입니다.
• WebP는 지원되지 않습니다. PNG / JPEG / GIF / SVG만 지원됩니다.
• 4:1은 지원되지 않습니다. 4096x1024은 400을 반환합니다. 최대 종횡비는 3:1입니다.
• 투명한 4K 출력은 안정적이지 않습니다. 긴 변이 4096인 높이를 여러 번 확인했으므로 3840x2160을 보장하지 마십시오. 투명한 출력은 2K 이하로 유지하십시오.
• quality에 의존하지 마십시오. low / medium / high는 허용되지만, low은 2K에서 2048x1153을 반환할 수 있는 반면 medium / high은 2048x2048을 반환합니다. 동일 시드에서 품질 차이는 확인되지 않았습니다.
• auto를 사용한 편집은 크기를 조정합니다. 출력은 입력 크기가 아니라 약 1.57 MP입니다.
• 콘텐츠 정책: 상위 단계의 콘텐츠 검토에서 400 content_policy_violation을 반환합니다. 프롬프트를 수정한 뒤 다시 시도하십시오.

​

오류

​

AI 에이전트로 연동하기

​

자주 묻는 질문

​

2K/4K는 기본 해상도인가요?

​

2K/4K 응답에서 size이 누락되는 이유는 무엇인가요?

​

투명한 4K 이미지를 생성할 수 있나요?

​

GIF 크기를 설정할 수 있나요?

​

WebP를 지원하나요?

​

quality이 중요한가요?

​

4096x1024이 실패하는 이유는 무엇인가요?

​

관련 문서

• 텍스트 기반 이미지 생성 API
• 이미지 편집 API
• GPT-Image-2.5-All 개요
• 공식 방식과 리버스 방식 비교
• 이미지 API 모범 사례