BizRouter 비즈라우터

이미지 API

OpenAI Images API와 호환되는 전용 이미지 생성/편집 엔드포인트입니다. OpenAI SDK를 그대로 사용할 수 있으며, GPT Image, Nano Banana(Gemini Image), Grok Imagine(xAI) 모델을 동일한 방식으로 호출할 수 있습니다. Chat Completions 기반 이미지 생성은 이미지 생성 문서를 참고하십시오.

엔드포인트

이미지 생성과 편집은 별도 엔드포인트로 제공됩니다 POST /v1/images/generations 텍스트 프롬프트로 이미지 생성 (JSON) POST /v1/images/edits 참조 이미지 기반 편집 (multipart/form-data) 인증은 Authorization: Bearer <API Key> 헤더를 사용합니다. 응답 이미지는 항상 b64_json 으로 반환되며, response_format: "url" 과 stream: true 는 지원하지 않습니다. GPT Image의 Chat Completions 스트리밍은 이미지 생성이 완료된 후 결과를 청크 단위로 전달합니다.

모델 호환성

이미지 출력을 지원하는 모든 모델을 사용할 수 있습니다 모델 패밀리 generations edits 비고 GPT Image (OpenAI) ✓ ✓ (참조 이미지 여러 장, 마스크) n 1~10, size / quality 지원 Nano Banana (예: google/gemini-3-pro-image ) ✓ ✓ (마스크 미지원) n=1 만 지원, size 는 화면 비율로 변환 Grok Imagine (예: x-ai/grok-imagine-image-2.0 ) ✓ ✓ (참조 이미지 최대 5장, 마스크 미지원) n 1~10, size 는 aspect_ratio 로 자동 변환, aspect_ratio / resolution 추가 지원 Seedream (예: bytedance/seedream-5.0-pro ) ✓ ✓ (참조 이미지 최대 10장, 마스크 미지원) n=1 만 지원, resolution 1k·1.5k·2k 또는 size 표준 3종, 투명 배경 편집

모델 호환성 · GPT Image 2.6 · 2.5 모델 선택

openai/gpt-image-2.6-sunburst 는 정교한 구도 표현과 이미지 편집 워크플로에 특화된 모델입니다. openai/gpt-image-2.6-flare 는 빠른 반복 작업에 특화된 모델입니다. openai/gpt-image-2.5-sunburst 는 정밀한 이미지 생성과 편집에 특화된 모델입니다. openai/gpt-image-2.5-flare 는 빠르고 고품질의 일상적인 이미지 생성에 특화된 모델입니다. 네 모델 모두 생성과 편집을 지원합니다. 모델 디스커버리 GET /v1/models 응답에서 output_modalities 에 image 가 포함된 모델이 이 엔드포인트를 지원합니다. 실제 제공 여부는 이 응답을 기준으로 확인해야 합니다.

이미지 생성

POST /v1/images/generations

이미지 생성 · 요청 파라미터

model 모델 코드 (필수) prompt 이미지 설명 텍스트 (필수) n 생성할 이미지 수, 1~10 (기본 1, GPT Image · Grok Imagine) · 일부 이미지만 정상으로 생성되면 그 이미지들만 담아 200으로 응답하므로 data 길이가 n 보다 짧을 수 있으며, 정상으로 받은 이미지만 청구합니다 size 1024x1024 · 1536x1024 · 1024x1536 · auto quality GPT Image 2.6 · 2.5 Sunburst·Flare: low · medium · high · xhigh · max · auto (기본 auto) 이전 GPT Image 모델: low · medium · high · auto Grok Imagine 2.0 전용: low · medium · auto output_format png · jpeg · webp (기본 png, GPT Image · Nano Banana) — GPT Image 2.6은 gif · svg도 받습니다. Grok Imagine은 output_format 미지원(모델이 PNG 또는 JPEG 선택) complexity GPT Image 2.6 전용 구성 복잡도: low · medium · high (생략하면 high). quality 와 별개이며 추가 요금이 없습니다 frame_count GPT Image 2.6 GIF 전용 프레임 수: 2~16 (기본 9). output_format: "gif" 일 때만 받습니다 frame_duration_ms GPT Image 2.6 GIF 전용 프레임 간격(ms): 20 이상 (기본 200, 2000을 넘으면 2000으로 맞춰집니다) svg GPT Image 2.6 SVG 전용: { "model": "openai/gpt-5.6-luna", "reasoning": { "effort": "low" } } . model (SVG를 쓰는 모델, 필수)은 BizRouter 모델 코드이고 reasoning 은 선택입니다 aspect_ratio Grok Imagine 전용 화면 비율 (auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 21:9 등). size 대신 직접 지정을 권장합니다 resolution Grok Imagine 1k · 1.5k · 2k, Seedream 1k · 1.5k · 2k (기본 2k). 높은 단계일수록 장당 단가가 높을 수 있습니다 Grok Imagine (xAI) background 과 output_compression 은 지원하지 않습니다. quality 는 x-ai/grok-imagine-image-2.0 만 받으며, 나머지 Grok Imagine 모델에 지정하면 400 오류가 반환됩니다. Seedream (ByteDance) bytedance/seedream-5.0-pro 와 bytedance/seedream-5.0-flash 는 요청마다 이미지 한 장을 만듭니다( n 은 1만). 크기는 resolution ( 1k · 1.5k · 2k , 기본 2k )이나 size 의 1024x1024 · 1536x1024 · 1024x1536 중 하나로 정하고, 둘을 함께 보내면 400 오류가 반환됩니다. 다른 비율은 프롬프트에 「16:9 가로 배너」처럼 적으면 모델이 맞춥니다. 편집( /v1/images/edits )은 참조 이미지를 최대 10장 받고, 알파 채널이 있는 이미지 한 장에 background: "transparent" 를 주면 투명 배경 PNG를 만듭니다. output_format 은 png · jpeg (기본 jpeg)입니다. 결과에 워터마크를 넣지 않으며, 넣으려면 watermark: true 를 보내세요. quality · output_compression · aspect_ratio · 마스크는 지원하지 않습니다. Pro는 1.5k 이하(표준 3종 포함) 장당 $0.045, 2k 장당 $0.09이고 참조 이미지는 첫 장 무료·둘째 장부터 장당 $0.003입니다. Flash는 크기와 관계없이 장당 $0.018, 참조 이미지 무료입니다. GPT Image 2.6: complexity · GIF · SVG openai/gpt-image-2.6-sunburst 와 openai/gpt-image-2.6-flare 만 받습니다. 다른 모델에 complexity , output_format: "gif" | "svg" , frame_count , frame_duration_ms , svg 를 보내면 400 오류가 반환됩니다. GIF는 생성과 편집 모두 되며, 프레임 전체가 이미지 한 장으로 과금됩니다(응답의 size 는 한 프레임의 크기입니다). SVG는 생성( /v1/images/generations )에서 n: 1 로만 되고, 이미지 모델이 그린 참조 이미지와 svg.model 이 SVG를 쓰는 데 쓴 토큰이 함께 과금됩니다. 작성 모델의 사용량은 응답의 svg_usage 에 그대로 오고 usage.cost (KRW)에 포함됩니다. 결과는 data[0].b64_json 의 base64 SVG(XML)입니다. cURL Node.js Python

이미지 생성 · 요청 예제 (Grok Imagine)

화면 비율과 해상도는 OpenAI 규격에 없는 필드이므로 추가 본문 필드로 전달합니다. OpenAI SDK에서는 extra_body 를 사용하십시오.

이미지 생성 · 응답 형식

아래 토큰 수는 응답 구조를 설명하기 위한 예시입니다. 특정 모델이나 품질의 실측값이 아니며, 실제 사용량과 비용은 요청마다 달라집니다.

이미지 편집

multipart/form-data POST /v1/images/edits 참조 이미지(GPT Image·Nano Banana 최대 16장, Grok Imagine 최대 5장, png/jpeg/webp)를 첨부해 편집·합성을 요청합니다. 여러 장을 첨부할 때는 image[] 필드를 반복합니다. 참조 이미지는 이미지 입력 토큰으로 과금되며, Grok Imagine은 참조 이미지 장당 과금됩니다. GPT Image 모델은 mask 필드로 인페인팅 마스크를 지원합니다. Nano Banana와 Grok Imagine 모델은 마스크 없이 프롬프트 기반 편집만 지원합니다. 요청 본문 최대 크기는 32MB입니다.

사용량 및 과금

응답의 usage 필드가 과금 기준입니다 usage 필드 적용 단가 input_tokens_details.text_tokens 입력 가격 (프롬프트 텍스트) input_tokens_details.image_tokens 이미지 입력 가격 (편집 시 참조 이미지) output_tokens_details.image_tokens 이미지 출력 가격 (생성된 이미지) cost 최종 과금액 (KRW) — 위 토큰 단가에 할인·마크업까지 반영된 값 생성 이미지의 토큰 수는 모델, 해상도( size ), 품질( quality )에 따라 달라집니다. 현재 모델별 가격은 모델 목록 에서, 실제 요청의 비용은 응답의 usage.cost 에서 확인합니다. Grok Imagine 모델은 토큰이 아닌 장당 과금입니다. 생성 이미지 한 장의 단가는 resolution 과 quality 에 따라 달라지고, 편집 시 참조 이미지도 장당 단가로 더해집니다. 이 경우 usage의 토큰 필드는 참고용이며 응답 usage.cost (원화)가 최종 과금액입니다.

에러 처리

콘텐츠 정책 거절 안전 정책에 걸리는 프롬프트나 이미지는 Provider 오류 또는 forbidden_content 오류로 반환됩니다. 일반적인 400 오류: 이미지 출력을 지원하지 않는 모델 ( output_modalities 확인) response_format: "url" 또는 stream: true 요청 Nano Banana 모델에 n > 1 또는 mask 지정 Grok Imagine 모델에 mask , background , output_compression 지정 또는 2.0 외 모델에 quality 지정 지원하지 않는 참조 이미지 형식 (png/jpeg/webp만 허용) GPT Image 2.6이 아닌 모델에 complexity , GIF·SVG 출력, frame_count · frame_duration_ms , svg 지정 output_format: "svg" 에 svg.model 이 없거나 n 이 1이 아님, 또는 편집·Chat Completions에서 SVG 요청

주식회사 AI3 | 서울 강남구 영동대로85길 34 | support@bizrouter.ai