OpenAI: GPT Image 1 Mini
GPT Image 1 Mini는 GPT Image 1 제품군에서 텍스트와 시각적 참조 자료를 바탕으로 이미지를 생성하고 편집합니다. 표준 출력 크기, 마스크, 일반적인 이미지 형식을 지원하며, GPT Image 1의 높은 입력 충실도 옵션 대신 낮은 입력 충실도를 사용합니다.
- Ailoot Ultra · 이미지
POST /v1/images/generationsopenai/gpt-image-1-mini - Ailoot Ultra · 이미지
POST /v1/images/generationsgpt-image-1-mini
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
GPT Image 1 Mini는 OpenAI의 GPT Image 1 제품군에서 Mini로 명명된 변형입니다. 텍스트와 이미지를 입력받아 제작사의 생성 및 편집 워크플로를 통해 이미지를 출력합니다. Mini 버전의 문서화된 제어 설정이 작업에 맞을 때 일반적인 창작 지침, 시각적 콘셉트, 제공된 이미지의 변경에 사용하세요. 작업을 준비할 때는 Mini의 표준 프레임 크기와 낮은 입력 충실도를 사용하세요.
새 이미지에서는 피사체, 장면, 빛, 구도, 스타일을 설명하세요. 편집에서는 필요한 변경과 알아볼 수 있게 유지해야 하는 원본 요소를 지정하세요. 간단한 일러스트 지침이라면 출입구 옆의 배달 자전거, 큼직하고 깔끔한 형태, 절제된 색상을 요청할 수 있습니다. 후속 요청에서는 선택한 구도를 유지하면서 배경을 바꿀 수 있습니다. 문서화된 직접 워크플로는 최대 32,000자의 프롬프트와 1~10개의 출력 이미지를 지원하여 검토할 대안을 제공할 수 있습니다.
편집에는 최대 16개의 입력 이미지를 사용할 수 있습니다. 역할을 모호하게 두지 말고, 어떤 이미지가 주요 피사체, 배경, 시각적 표현 방식을 제공하는지 설명하세요. GPT Image 1 Mini는 input_fidelity에서 low만 지원합니다. GPT Image 1에서 사용할 수 있는 high 설정은 Mini의 옵션이 아닙니다. 입력 충실도는 출력 렌더링 품질과 별개입니다. 고품질 출력을 선택해도 다른 원본 보존 모드가 활성화되지는 않습니다. 보존 요구 사항을 명확히 하고 결과물에서 관련 원본 세부 사항을 확인하세요.
마스크는 선택한 영역에 요청한 변경을 유도할 수 있습니다. 원본과 마스크의 형식 및 크기가 같아야 하며, 마스크에는 알파 채널이 필요합니다. 이미지 생성 가이드는 50 MB 미만이라는 요구 사항을 명시합니다. 원본 이미지가 여러 개면 마스크는 첫 번째에 적용됩니다. 집중된 지침으로 장면의 전체 프레이밍을 유지하면서 한 물체의 색상을 바꿀 수 있습니다. 마스크는 보장된 기하학적 경계가 아니라 프롬프트 기반 안내이므로, 의도한 변경뿐 아니라 인접 영역도 확인하세요.
표준 프레임 크기는 1024 × 1024, 1536 × 1024, 1024 × 1536픽셀이며, 지원되는 경우 자동 선택을 사용할 수 있습니다. 렌더링 품질 선택지는 low, medium, high, auto입니다. 이는 low만 지원하는 Mini의 입력 충실도와 별개입니다. 이후 GPT Image 에디션의 사용자 지정 고해상도 크기와 xhigh 또는 max 수준은 이 Mini 프로필에 포함되지 않습니다. 배치할 위치에 맞는 프레임과 초안 또는 완성된 결과물에 적절한 품질 수준을 선택하세요.
제작사는 PNG, JPEG, WebP 출력을 지원하며 기본값은 PNG입니다. JPEG와 WebP는 0부터 100까지의 압축을 사용할 수 있습니다. 투명, 불투명, 자동 배경은 서로 다른 레이아웃 요구에 대응합니다. 알파 채널이 필요하다면 PNG 또는 WebP를 선택하세요. 투명한 물체는 별도 구도에 배치할 수 있고, 불투명한 장면은 자체 배경을 포함합니다. 인코딩된 전달 표현을 최종 디자인 산출물로 취급하지 말고 선택한 출력 파일을 보관하세요.
제작사의 이미지 참조 문서는 완료 전에 최대 3개의 부분 이미지를 제공하는 스트리밍을 설명합니다. 미리보기는 진행 상태를 보여 줄 수 있지만, 완성된 결과로 보관할 것은 최종 이미지뿐입니다. 편집을 이어 갈 때는 선택한 이미지와 다음 구체적인 지시를 다시 제공하세요. 제조사의 인터페이스는 배치 처리도 지원합니다.
이미지의 글자, 레이아웃에 민감한 세부 사항, 원본 물체의 모습을 지침과 대조해 검토하세요. GPT Image는 정확한 텍스트 배치, 구조화된 구도, 생성 간 반복 피사체의 일관성에서 여전히 어려움을 겪을 수 있습니다. 보이는 세부 사항을 바꿔야 한다면 선택한 결과를 좁은 범위의 편집에 사용하고, 변경 및 보존 요구 사항을 모두 명확히 유지하세요. 유용한 Mini 결과는 정확히 이 에디션이 제공하는 표준 크기와 충실도 제어 설정으로 준비한, 정의된 창작 작업의 완성된 이미지입니다.
Ailoot Ultra · 이미지 POST /v1/images/generations openai/gpt-image-1-mini
openai/gpt-image-1-miniopenai/gpt-image-1-minigpt-image-1-mini
시작하기
GPT Image 1 Mini는 GPT Image 1 제품군에서 텍스트와 시각적 참조 자료를 바탕으로 이미지를 생성하고 편집합니다. 표준 출력 크기, 마스크, 일반적인 이미지 형식을 지원하며, GPT Image 1의 높은 입력 충실도 옵션 대신 낮은 입력 충실도를 사용합니다.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 이미지 POST /v1/images/generations
- 입력
text,image- 출력
image
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 openai/gpt-image-1-mini | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 1:1, 3:2, 2:3, auto | 기본값— |
필드quality | 유형string | 요건선택 사항 | 값과 한도 auto, low, medium, high | 기본값— |
필드background | 유형string | 요건선택 사항 | 값과 한도 auto, transparent, opaque | 기본값— |
필드n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 최댓값: 10 | 기본값— |
필드input_references | 유형array | 요건선택 사항 | 값과 한도 최소 항목 수: 0 최대 항목 수: 16 | 기본값— |
필드output_compression | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 0 최댓값: 100 | 기본값— |
필드provider | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수material_types | 명세text, image |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.065536 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 이미지
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-1-mini', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 이미지
반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
완료된 결과 모두 보관
완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드created | 유형 |
필드data[].url | 유형 |
필드data[].b64_json | 유형 |
필드usage | 유형 |
별칭
모델 별칭
Ailoot Ultra openai/gpt-image-1-mini, gpt-image-1-mini
메서드 경로 별칭
/v1/images
관련 호출용 ID
Ailoot Ultra · 이미지 POST /v1/images/generations gpt-image-1-mini
gpt-image-1-miniopenai/gpt-image-1-minigpt-image-1-mini
시작하기
GPT Image 1 Mini는 GPT Image 1 제품군에서 텍스트와 시각적 참조 자료를 바탕으로 이미지를 생성하고 편집합니다. 표준 출력 크기, 마스크, 일반적인 이미지 형식을 지원하며, GPT Image 1의 높은 입력 충실도 옵션 대신 낮은 입력 충실도를 사용합니다.
- 허용 입력
- 텍스트
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 이미지 POST /v1/images/generations
- 입력
text- 출력
image
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 gpt-image-1-mini | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 최대 길이: 32,000 | 기본값— |
필드size | 유형string | 요건선택 사항 | 값과 한도 1024x1024, 1536x1024, 1024x1536, auto | 기본값auto |
필드background | 유형string | 요건선택 사항 | 값과 한도 transparent, opaque, auto | 기본값auto |
필드moderation | 유형string | 요건선택 사항 | 값과 한도 low, auto 조건: 표준 콘텐츠 검토에는 auto를 사용하세요. | 기본값— |
필드n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 최댓값: 10 | 기본값1 |
필드quality | 유형string | 요건선택 사항 | 값과 한도 auto, high, medium, low | 기본값auto |
필드output_compression | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 0 최댓값: 100 조건: JPEG 및 WebP 출력에 적용됩니다. 문서에 명시된 정수 값을 전송하세요. | 기본값100 |
필드output_format | 유형string | 요건선택 사항 | 값과 한도 webp, png, jpeg | 기본값png |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false 조건: 이 경로는 완료된 JSON 응답 하나를 반환합니다. | 기본값false |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세prompt, model |
매개변수material_types | 명세text |
매개변수optional | 명세size, background, moderation, n, quality, output_compression, output_format, stream |
매개변수conditions | 명세투명 배경에는 PNG 또는 WebP가 필요합니다., 출력 압축은 JPEG 또는 WebP에 적용됩니다., 선택한 메서드는 텍스트로 생성합니다. 제조사 설명에 있는 편집 및 스트리밍 제어는 별도의 기능입니다. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.065536 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 이미지
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1-mini', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 이미지
반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
완료된 결과 모두 보관
완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드created | 유형 |
필드data[].url | 유형 |
필드data[].b64_json | 유형 |
필드usage | 유형 |
별칭
모델 별칭
Ailoot Ultra openai/gpt-image-1-mini, gpt-image-1-mini
메서드 경로 별칭
/v1/images
관련 호출용 ID
FAQ · OpenAI: GPT Image 1 Mini
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·openai/gpt-image-1-mini:text,image→imagePOST /v1/images/generations·gpt-image-1-mini:text→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·openai/gpt-image-1-mini:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,providerPOST /v1/images/generations·gpt-image-1-mini:model,prompt,size,background,moderation,n,quality,output_compression,output_format,stream- 어떤 제한이 적용되나요?
POST /v1/images/generations·openai/gpt-image-1-mini:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100POST /v1/images/generations·gpt-image-1-mini:prompt.maximum_length:32000;n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100