이미지 API 개요

APIMaster는 https://apimaster.ai/v1 아래에 이미지 API를 제공합니다. 이미지-투-이미지는 모든 모델에서 하나의 범용 입력 형식을 사용하지 않습니다. 모델을 먼저 선택한 다음, 해당 모델의 문서화된 엔드포인트와 참조 필드를 사용하세요.

모델 및 엔드포인트 가이드

모델	텍스트-투-이미지	이미지-투-이미지	가이드
gpt-image-2	JSON /images/generations	멀티파트 /images/edits, image / image[] 파일	GPT Image 2 / 2.5
gpt-image-2.5-sunburst	JSON /images/generations	멀티파트 /images/edits, image / image[] 파일	GPT Image 2 / 2.5
gpt-image-2.5-flare	JSON /images/generations	멀티파트 /images/edits, image / image[] 파일	GPT Image 2 / 2.5
gemini-3.1-flash-image-preview	JSON /images/generations	image_urls를 사용하는 JSON /images/generations	Gemini Flash Image
gemini-nano-banana-2.1	JSON /images/generations	multipart /images/edits / JSON image_urls	Nano Banana 2.1
grok-imagine-image-2.0	JSON /images/generations	image_urls(최대 5개)를 사용하는 JSON /images/generations	Grok Imagine Image 2.0
doubao-seedream-5-0-pro-260628	JSON /images/generations	image를 사용하는 JSON /images/generations	Seedream 5.0 Pro
midjourney-v8.2	비동기 /midjourney/generations	JSON image_urls 참조	Midjourney v8.2 / Niji 7
midjourney-niji-7	비동기 /midjourney/generations	JSON image_urls 참조	Midjourney v8.2 / Niji 7

Grok Imagine Image 2.0의 경우 image_urls와 함께 동기식 /images/generations를 사용하세요. 클라이언트 비동기 및 /images/edits 경로는 지원되지 않습니다. Grok Imagine Image 2.0 가이드를 참조하세요.

GPT 참조 이미지의 경우 이미지 응답에는 /images/edits에, 작업 응답에는 /images/edits/async에 실제 파일을 업로드하세요. Gemini 또는 Seedream JSON 형식을 복사하지 마세요. 프롬프트에서 참조를 언급하는 것은 업로드가 아닙니다. GPT Image 2.5는 별도의 모델 패밀리이며 GPT Image 2의 별칭이 아닙니다.

Midjourney v8.2와 Niji 7은 /midjourney/generations를 통해 비동기 작업을 생성합니다. GET /tasks/{task_id}를 폴링하세요. 매개변수와 예시는 Midjourney v8.2 / Niji 7 가이드를 참조하세요.

인증 및 응답

• 콘솔에서 키를 생성한 다음 Authorization: Bearer YOUR_API_KEY를 전송하세요.
• JSON 생성 호출은 Content-Type: application/json을 사용합니다. 멀티파트 편집의 경우 HTTP 클라이언트가 Content-Type과 boundary를 생성하도록 하세요.
• 동기식 이미지 응답은 url 또는 b64_json이 포함된 data[]를 포함합니다. 두 형식을 모두 처리하세요. 임시 URL은 즉시 다운로드하세요.
• 선택적 필드, 참조 제한, 크기 및 가격은 모델과 사용 가능한 경로에 따라 다릅니다. 모델 가이드와 마켓플레이스를 확인하세요.

비동기 작업

POST /images/generations/async, POST /images/edits/async 및 GET /tasks/{task_id}?model=MODEL_ID는 지원되는 모델에 작업 기반 이미지 워크플로를 제공합니다. 이는 모든 이미지 작업을 위한 범용 모드가 아닙니다:

• GPT Image 2, Sunburst 및 Flare의 경우 텍스트-투-이미지에는 JSON generations/async를, 편집에는 멀티파트 edits/async를 사용하세요. 동기식 편집과 동일한 파일을 업로드한 다음, 제출한 계정과 동일한 모델 ID로 폴링하세요.
• 생성 또는 편집은 비동기 제출이 작업 ID를 반환하기 전에 완료될 수 있습니다. 제출이 즉시 이루어진다고 가정하지 마세요. 폴링 중인 기존 작업을 다시 제출하지 마세요. 완료 상태는 succeeded, success 또는 completed일 수 있습니다. 추적된 결과는 문자열 url을 사용하지만, 레거시 결과에는 URL 배열이 포함될 수 있습니다.
• Gemini에는 자체 비동기 생성 흐름이 있습니다. 참조 입력은 해당 가이드를 따르세요.
• Seedream 5.0 Pro는 동기식 생성을 사용하며 /images/generations/async를 지원하지 않습니다.

전체 cURL/Python 예시, 폴링 상태 및 문제 해결은 모델 가이드를 참조하세요. HTTP 200 응답만으로는 참조 이미지 충실도를 검증할 수 없습니다.