GPT Image 2.6

SeedRouter의 비동기 이미지 API를 통해 GPT Image 2.6으로 이미지를 생성·편집하고 애니메이션 GIF와 SVG 출력을 요청하세요.

GPT Image 2.6은 텍스트 프롬프트와 선택적인 참조 이미지를 받습니다. POST /v1/images/generations에 한 번 제출하고 태스크 ID를 보관한 뒤 GET /v1/tasks/{id}를 폴링해 결과를 받으세요. 완성된 파일은 URL로 반환됩니다.

모델 ID와 가격

GET /v1/models로 키에서 이용할 수 있는 모델을 확인하세요. 설정된 Sunburst ID는 gpt-image-2.6-sunburst-official과 gpt-image-2.6-sunburst입니다. Flare ID가 표시되면 같은 파라미터 계약을 사용합니다. 접미사 없는 모델 ID는 Default 그룹을 사용하며 추가 그룹은 모델 조회 결과에 나오는 model:group ID를 사용합니다.

현재 가격과 Playground를 확인하세요. 토큰 과금 모델은 실제 사용량으로 정산하며 이미지당 과금 모델은 설정된 이미지 단가를 사용합니다. SVG 응답은 코드 생성 모델의 토큰을 svg_usage에 별도로 보고하며 해당 모델의 SeedRouter 자체 가격으로 과금합니다.

이미지 생성하기

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

응답에는 id가 포함됩니다. 생성을 다시 제출하지 말고 해당 ID를 폴링하세요.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

완료되면 output.data에 url을 가진 객체가 포함됩니다. 원래 파일 형식과 GIF의 모든 애니메이션 프레임을 유지하려면 해당 URL에서 다운로드하세요. 실패한 태스크에는 error가 있으며 과금하지 않습니다. 태스크 상태와 폴링을 확인하세요.

파라미터

최상위 필드는 18개입니다. model과 prompt만 필수입니다. 선택 필드는 null을 허용하며 생략과 동일하게 처리합니다. 알 수 없는 필드는 버립니다. 지원 필드의 값이 유효하지 않으면 이미지 생성 전에 검증에서 거부됩니다.

필드	타입	기본값 및 제약
`model`	string	필수. 키에서 사용할 수 있는 ID를 지정하세요.
`prompt`	string	필수, 공백 불가, 최대 32,000 유니코드 문자.
`n`	integer	1. 범위 1~10. SVG는 1이어야 합니다.
`size`	string	`auto` 또는 `WIDTHxHEIGHT`. 아래 크기 규칙을 참고하세요.
`quality`	string	`auto`. `low`, `medium`, `high`, `xhigh`, `max`도 가능.
`background`	string	`auto`. `opaque`, `transparent`도 가능. JPEG는 투명 배경을 지원하지 않습니다.
`output_format`	string	`png`. `jpeg`, `gif`, `svg`도 가능. WebP 출력은 제공하지 않습니다.
`output_compression`	integer	JPEG는 100. 0~100. `output_format: "jpeg"`일 때만 전달하세요.
`moderation`	string	`auto`. `low`도 가능. 공개 Playground에서는 `low`가 API 전용입니다.
`complexity`	string	`high`. `low`, `medium`도 가능. 계획 수준이며 별도 추가 요금은 없습니다.
`frame_count`	integer	9. 범위 2~16. GIF 전용.
`frame_duration_ms`	integer	200. 최소 20밀리초이며 최댓값은 없습니다. GIF 전용. 인코더가 가장 가까운 10ms로 반올림하고 각 프레임을 최대 655,350ms로 제한합니다.
`svg`	object	생략. 코드 생성 모델 선택은 선택 사항이며 아래를 참고하세요.
`images`	array	`{"image_url":"https://..."}` 형태의 객체 1~16개. 편집으로 전환합니다.
`mask`	object	`{"image_url":"https://..."}`. `images`가 필요하며 `markup`과 함께 사용할 수 없습니다.
`markup`	object	`{"image_url":"https://..."}`. `images`가 필요하며 `mask`와 함께 사용할 수 없습니다.
`safety_identifier`	string	선택적인 고정 최종 사용자 식별자, 최대 128자. 비어 있지 않은 값은 `user`보다 우선합니다.
`user`	string	지원 중단 예정인 선택적 최종 사용자 식별자. Playground에 표시하지 않으며 자동으로 채우지 않습니다.

참조 URL은 HTTP 또는 HTTPS를 사용해야 하며 인증 정보를 포함해서는 안 됩니다. 파일 ID, 인라인 base64 및 multipart 업로드는 받지 않습니다. 파일을 먼저 업로드한 뒤 공개 URL을 전달하세요. 요청은 stream이나 partial_images 대신 비동기 태스크 폴링을 사용합니다. 이 계약은 input_fidelity, response_format 및 prompt_rewriter를 공개하지 않습니다.

이미지 크기

PNG, JPEG 및 SVG 참조 이미지 생성에서는 각 변이 16의 배수이며 3840픽셀 이하여야 합니다. 총 픽셀 수는 655,360~~8,294,400이며 화면비는 1:3~~3:1이어야 합니다. 예: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

GIF의 각 변은 16의 양의 배수이거나 auto여야 합니다. GIF는 프레임 수, 프레임 크기 및 n이 공유하는 별도의 총 픽셀 한도가 있으며 OpenAI는 수치 한도를 공개하지 않았습니다. 512x512 GIF에는 정지 이미지의 최소 픽셀 규칙이 적용되지 않습니다.

애니메이션 GIF

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF는 프롬프트로 생성하거나 참조 이미지로 요청할 수 있습니다. 마스크나 압축과 함께 사용하지 마세요. 미리보기 이용 가능 여부는 선택한 모델의 접근 권한에 따라 달라질 수 있습니다.

문서 간 차이, 2026년 11월 5일 확인: OpenAI 이미지 생성 가이드는 2~~64프레임과 20~~2000ms를 명시하고 편집 엔드포인트는 GIF를 반환하지 않는다고 설명합니다. Images API 레퍼런스는 2~16프레임, 표시 시간 최댓값 없음으로 명시하고 편집의 GIF 출력도 기재합니다. 2026년 11월 5일 전송한 요청은 레퍼런스와 일치했습니다. 17프레임은 거부되었고 3,000ms 프레임은 허용되었습니다. 이 API는 레퍼런스를 따릅니다.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG는 생성 전용이며 n: 1이 필요합니다. 이미지, 마스크, 표시 이미지 또는 압축을 전달하지 마세요. 파일은 벡터 도형을 담은 정적 UTF-8 XML이며 스크립트, 외부 리소스 및 내장 래스터 이미지는 지원하지 않습니다.

코드 생성 모델 선택이 가능하면 svg: {"model":"YOUR_AUTHOR_MODEL_ID"}를 추가하세요. svg 객체를 명시하면 비어 있지 않은 model이 필요합니다. svg.reasoning.effort를 none, minimal, low, medium, high, xhigh 또는 max로 설정할 수도 있으며 지원 값은 선택한 코드 생성 모델에 따라 달라집니다. 기본값을 쓰려면 reasoning을 생략하세요. OpenAI는 코드 생성 모델 허용 목록이나 공통 기본값을 공개하지 않습니다. 모델 선택이 불가능하면 svg 객체 전체를 생략하세요.

완성된 결과에는 model, input_tokens, output_tokens, reasoning_tokens 및 total_tokens를 포함하는 svg_usage가 있을 수 있습니다. 이는 이미지 usage와 별개이며 추가 이미지 토큰 수가 아닙니다.

참조 이미지, 마스크 및 표시 이미지

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

참조 이미지는 PNG, JPEG 및 WebP를 지원하며 파일당 최대 50MB입니다. 마스크와 표시 이미지는 PNG여야 하며 방향을 적용한 첫 번째 참조 이미지와 크기가 같아야 합니다. 표시 이미지에는 투명 픽셀이 있어야 합니다. 표시 이미지와 첫 번째 참조 이미지는 각각 최대 16,777,216픽셀이며 표시 이미지는 최대 50MB입니다. 마스크와 표시 이미지는 함께 사용할 수 없습니다.

응답 필드

완성된 이미지 출력에는 created, data: [{url}] 및 보고되는 경우 size, quality, background, output_format, usage, svg_usage, safety_identifier가 포함됩니다. usage는 텍스트/이미지 입력 및 출력 토큰과 캐시된 입력을 나눠 보고할 수 있습니다. 공개 출력에는 base64 이미지 바이트나 비용 필드가 포함되지 않습니다.

OpenAPI 스키마 · OpenAI 생성 레퍼런스 · OpenAI 편집 레퍼런스 · OpenAI 이미지 가이드

On this page