이미지 생성
BizRouter는 이미지 생성 기능을 지원합니다. Nano Banana(Gemini Image), GPT Image, Grok Imagine(xAI) 모델 모두 동일한 Chat Completions 방식으로 사용할 수 있으며, 생성된 이미지는 Base64 형식으로 응답에 포함되고 스트리밍 모드에서는 청크 단위로 전송됩니다. OpenAI SDK 호환 전용 엔드포인트가 필요하면 이미지 API 문서를 참고하십시오. 이미지 생성 모델 선택 GET /v1/models 응답에서 output_modalities 에 image 가 포함된 모델을 선택합니다. 모델 제공 상태는 변경될 수 있으므로 실제 제공 여부는 이 응답을 기준으로 확인해야 합니다.
모델 패밀리 및 파라미터 호환성
모델 패밀리에 따라 지원하는 이미지 옵션이 다릅니다 파라미터 Nano Banana (Gemini Image) GPT Image (OpenAI) Grok Imagine (xAI) aspect_ratio ✓ 미지원 ✓ image_size ✓ (Gemini 3 Pro / Nano Banana 2.1) 미지원 미지원 resolution 미지원 미지원 ✓ (1k · 2k) size 미지원 ✓ △ ( aspect_ratio 로 자동 변환) quality 미지원 ✓ ✓ (grok-imagine-image-2.0 전용) 세 패밀리 모두 마지막 user 메시지의 텍스트를 프롬프트로 사용하고, 첨부한 이미지는 편집(레퍼런스) 입력으로 처리됩니다. 응답과 스트리밍 형식은 패밀리와 무관하게 동일합니다. Grok Imagine은 output_format을 받지 않으며 모델이 PNG 또는 JPEG를 선택합니다.
이미지 생성 옵션
화면 비율 및 해상도 설정
이미지 생성 옵션 · 화면 비율 (Aspect Ratio)
aspect_ratio 파라미터로 생성할 이미지의 화면 비율을 지정할 수 있습니다. Nano Banana(Gemini Image) 와 Grok Imagine(xAI) 이 지원하며, 허용 값은 패밀리마다 다릅니다. Nano Banana Grok Imagine
이미지 생성 옵션 · 이미지 해상도 (Image Size)
image_size 파라미터로 이미지 해상도를 지정할 수 있습니다. Gemini 3 Pro 및 Nano Banana 2.1 모델 전용 옵션입니다. 1K 2K 4K 지원 값과 대소문자 validation은 선택한 모델과 Provider에 따라 달라질 수 있습니다. 요청이 거절되면 Provider 오류 body를 확인하십시오.
이미지 생성 옵션 · GPT Image 옵션 (size / quality)
GPT Image 모델은 size 와 quality 파라미터를 지원합니다. openai/gpt-image-2.6-sunburst 는 정교한 구도 표현과 이미지 편집 워크플로에, openai/gpt-image-2.6-flare 는 빠른 반복 작업에 특화되어 있습니다. 두 모델 모두 생성과 편집을 지원합니다. openai/gpt-image-2.5-sunburst 는 정밀한 이미지 생성과 편집에, openai/gpt-image-2.5-flare 는 빠르고 고품질의 일상적인 이미지 생성에 특화되어 있습니다. 두 모델 모두 생성과 편집을 지원합니다. GPT Image 2.6·2.5 Sunburst·Flare의 품질 옵션 (기본 auto) 이전 GPT Image 모델은 low · medium · high · auto를 지원합니다. xhigh와 max는 GPT Image 2.6·2.5 전용 옵션입니다. GPT Image 2.6은 요청 본문에 complexity (low · medium · high)와 애니메이션 GIF( output_format: "gif" , frame_count 2~16, frame_duration_ms )도 받습니다. GIF는 image_url 의 data URI가 image/gif 로 옵니다. SVG 출력은 /v1/images/generations 에서만 됩니다( Images API ). 토큰 사용량은 모델, 크기, 품질에 따라 달라집니다. 현재 모델별 가격은 모델 목록 에서, 실제 비용은 응답의 usage.cost (KRW)에서 확인합니다.
이미지 생성 옵션 · Grok Imagine 옵션 (aspect_ratio / resolution / quality)
Grok Imagine 모델은 aspect_ratio 와 resolution (1k · 1.5k · 2k)을 지원합니다. quality (low · medium · auto)는 grok-imagine-image-2.0 전용 이며, 다른 Grok Imagine 모델에 지정하면 400 오류가 반환됩니다. OpenAI 규격의 size 를 보내면 가장 가까운 화면 비율로 변환되지만, aspect_ratio 를 직접 지정하는 편이 명확합니다. Grok Imagine은 토큰이 아닌 장당 과금이며, 1.5k·2k 해상도와 medium 품질은 장당 단가를 올립니다. 참조 이미지를 첨부하면 장당 단가가 추가되고, 응답 usage.cost (원화)가 최종 과금액입니다.
응답 형식
이미지가 포함된 응답 구조
응답 형식 · 일반 응답 (Non-streaming)
이미지는 content 필드에 배열 형태로 반환되며, text와 image_url 타입이 함께 포함될 수 있습니다. 아래 토큰 수는 응답 구조를 설명하기 위한 예시이며, 실제 사용량은 요청마다 달라집니다. GPT Image 모델은 참조 이미지를 첨부한 경우 usage에 image_input_tokens 가 추가로 포함되며, 이미지 입력 단가로 별도 과금됩니다.
응답 형식 · 텍스트만 포함된 응답
이미지 생성 없이 텍스트만 반환되는 경우, content는 문자열로 직접 반환됩니다.
스트리밍 응답
이미지를 청크 단위로 전송하는 스트리밍 모드 청크 방식 전송 큰 이미지는 1KB 단위의 청크로 나뉘어 전송됩니다. 각 청크에는 메타데이터가 포함되어 클라이언트에서 재조합할 수 있습니다. GPT Image 모델은 이미지 생성이 완료된 후 결과를 청크 단위로 전달합니다. 따라서 첫 이미지 청크를 받기까지 생성 완료를 기다려야 합니다.
스트리밍 응답 · 이미지 청크 형식
스트리밍에서 이미지는 image_url_chunk 타입으로 전송됩니다.
스트리밍 응답 · 청크 메타데이터
image_idx 응답에 포함된 이미지의 인덱스 (0부터 시작) chunk_index 현재 청크의 순서 번호 total_chunks 전체 청크 개수 mime_type 이미지 MIME 타입 (예: image/png, image/jpeg) is_last_chunk 마지막 청크 여부
스트리밍 응답 · 스트리밍 완료
모든 청크 전송이 완료되면 usage 정보와 함께 [DONE] 메시지가 전송됩니다.
클라이언트 구현 예제
서비스 API Key가 노출되지 않는 server 환경에서 이미지 청크를 재조합합니다. Node.js Python
에러 처리
이미지 생성 실패 시 응답 이미지 생성 실패 안전 정책으로 이미지 출력이 차단되면 정상 Chat Completions 응답과 함께 finish_reason: "content_filter" 가 반환됩니다. 실제 생성 오류는 BizRouter 오류 또는 Provider의 원본 status/body로 반환될 수 있습니다. 일반적인 실패 이유: IMAGE_SAFETY : 안전 필터 차단, content_filter 로 반환 IMAGE_PROHIBITED_CONTENT / IMAGE_RECITATION : 정책 차단, content_filter 로 반환 IMAGE_OTHER / NO_IMAGE : 이미지 생성 오류 MAX_TOKENS : 토큰 한도 초과, length 로 반환
주의사항
이미지 크기 생성된 이미지는 Base64 인코딩되어 있어 원본보다 약 33% 더 큰 용량을 차지합니다. 스트리밍 처리 스트리밍 모드에서는 모든 청크를 수신할 때까지 이미지를 표시할 수 없습니다.