{ "aboutHtml": "

텍스트 설명으로 만드는 일상적인 이미지

GPT Image 2.5 Flare는 이미지를 만드는 OpenAI 모델입니다. 개발사에 따르면 고품질 시각 자료를 일상적으로 빠르게 생성하는 것이 목적입니다. 지시에서 이야기, 스타일, 세부 요소의 배치, 원하는 화면 형태를 설명할 수 있으며 결과는 이미지입니다.

Ailoot의 이 카드는 텍스트 입력의 생성으로 표시되어 있습니다. OpenAI는 원본 이미지, 참고 자료, 수정 작업도 설명합니다. 이런 방식에는 입력 이미지 지원이 필요합니다. 텍스트 호출 방식이 이미 해당 자료를 입력받는다는 뜻은 아닙니다.

초안부터 상세한 이미지까지의 품질

low, medium, high, xhigh, max 수준과 자동 선택 auto를 지원합니다. 품질 설정은 결과를 구성하는 작업량에 영향을 줍니다. 화면 크기와 완성된 파일의 압축과는 별도로 지정합니다.

크기에는 정사각형, 가로형, 세로형, 자동 선택, 사용자 지정 크기가 있습니다. 개발사의 모든 제한을 지키면서 구도에 맞는 비율을 선택할 수 있습니다.

사용자 지정 크기

각 변은 16픽셀의 배수이며 3840픽셀 이하여야 합니다. 긴 변과 짧은 변의 비율은 최대 3:1입니다. 허용 면적은 655 360~8 294 400픽셀입니다. 제한은 함께 적용됩니다. 허용 화면 비율이 면적 제한을 없애지는 않습니다.

2560x1440보다 높은 해상도는 실험적인 것으로 표시되어 있습니다. 큰 화면을 선택할 때에는 구도 자체를 고려해야 합니다. 픽셀이 더 많다고 모든 요소가 오류 없이 배치되는 것은 아닙니다.

결과 파일과 투명도

모델은 PNG, JPEG, WebP를 제공하며 기본 형식은 PNG입니다. JPEG와 WebP에서는 압축을 조절할 수 있습니다. 투명 배경에는 PNG나 WebP가 필요합니다. 개발사는 불투명 배경과 자동 선택도 지원합니다. 투명도는 지정된 바탕 없이 이미지를 이후 구도에 사용할 수 있게 합니다.

개발사의 설정은 모델의 기능을 설명합니다. 실행은 선택한 호출 방식의 설정 지원에 따라 달라집니다. 개별 생성은 새로운 결과를 만드므로 같은 설명이 이미지의 완전한 일치를 보장하지는 않습니다.

완성된 이미지에서 확인할 점

OpenAI에 따르면 복잡한 지시 처리는 최대 2분이 걸릴 수 있습니다. 이는 개발사의 생성에 대한 설명이며 특정 애플리케이션에서 결과를 받을 때까지의 전체 시간을 보장하는 것은 아닙니다.

글자, 대상의 정확한 위치, 이미지 사이의 동일한 외형 유지는 확인해야 합니다. 별도로 지원되는 편집 작업의 마스크는 변경 방향을 정하며 엄격한 경계가 아닙니다. 텍스트 생성에서는 구도를 정확하게 설명하고 파일 자체의 보이는 세부 요소, 가독성, 지정한 이야기와의 일치 여부를 확인하는 것이 유용합니다.

", "aboutText": "### 텍스트 설명으로 만드는 일상적인 이미지\n\nGPT Image 2.5 Flare는 이미지를 만드는 OpenAI 모델입니다. 개발사에 따르면 고품질 시각 자료를 일상적으로 빠르게 생성하는 것이 목적입니다. 지시에서 이야기, 스타일, 세부 요소의 배치, 원하는 화면 형태를 설명할 수 있으며 결과는 이미지입니다.\n\nAiloot의 이 카드는 텍스트 입력의 생성으로 표시되어 있습니다. OpenAI는 원본 이미지, 참고 자료, 수정 작업도 설명합니다. 이런 방식에는 입력 이미지 지원이 필요합니다. 텍스트 호출 방식이 이미 해당 자료를 입력받는다는 뜻은 아닙니다.\n\n### 초안부터 상세한 이미지까지의 품질\n\n`low`, `medium`, `high`, `xhigh`, `max` 수준과 자동 선택 `auto`를 지원합니다. 품질 설정은 결과를 구성하는 작업량에 영향을 줍니다. 화면 크기와 완성된 파일의 압축과는 별도로 지정합니다.\n\n크기에는 정사각형, 가로형, 세로형, 자동 선택, 사용자 지정 크기가 있습니다. 개발사의 모든 제한을 지키면서 구도에 맞는 비율을 선택할 수 있습니다.\n\n### 사용자 지정 크기\n\n각 변은 16픽셀의 배수이며 3840픽셀 이하여야 합니다. 긴 변과 짧은 변의 비율은 최대 3:1입니다. 허용 면적은 655 360~8 294 400픽셀입니다. 제한은 함께 적용됩니다. 허용 화면 비율이 면적 제한을 없애지는 않습니다.\n\n`2560x1440`보다 높은 해상도는 실험적인 것으로 표시되어 있습니다. 큰 화면을 선택할 때에는 구도 자체를 고려해야 합니다. 픽셀이 더 많다고 모든 요소가 오류 없이 배치되는 것은 아닙니다.\n\n### 결과 파일과 투명도\n\n모델은 PNG, JPEG, WebP를 제공하며 기본 형식은 PNG입니다. JPEG와 WebP에서는 압축을 조절할 수 있습니다. 투명 배경에는 PNG나 WebP가 필요합니다. 개발사는 불투명 배경과 자동 선택도 지원합니다. 투명도는 지정된 바탕 없이 이미지를 이후 구도에 사용할 수 있게 합니다.\n\n개발사의 설정은 모델의 기능을 설명합니다. 실행은 선택한 호출 방식의 설정 지원에 따라 달라집니다. 개별 생성은 새로운 결과를 만드므로 같은 설명이 이미지의 완전한 일치를 보장하지는 않습니다.\n\n### 완성된 이미지에서 확인할 점\n\nOpenAI에 따르면 복잡한 지시 처리는 최대 2분이 걸릴 수 있습니다. 이는 개발사의 생성에 대한 설명이며 특정 애플리케이션에서 결과를 받을 때까지의 전체 시간을 보장하는 것은 아닙니다.\n\n글자, 대상의 정확한 위치, 이미지 사이의 동일한 외형 유지는 확인해야 합니다. 별도로 지원되는 편집 작업의 마스크는 변경 방향을 정하며 엄격한 경계가 아닙니다. 텍스트 생성에서는 구도를 정확하게 설명하고 파일 자체의 보이는 세부 요소, 가독성, 지정한 이야기와의 일치 여부를 확인하는 것이 유용합니다.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a2eb0303ad8edb93e5145dfcbc8d01a9a003b087ca818f5bf82832a4c54428a2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ko", "methods": [ { "html": "

O

GPT Image 2.5 Flare 2026-09-08

OpenAI /gpt-image-2.5-flare-2026-09-08

시작하기

GPT Image 2.5 Flare는 설명을 바탕으로 하는 일상적인 이미지 생성을 위한 모델입니다. 사용자 지정 크기, 확장된 품질 수준, 투명 배경을 제공합니다.

허용 입력: 텍스트
결과: 이미지

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

텍스트 설명으로 만드는 일상적인 이미지

GPT Image 2.5 Flare는 이미지를 만드는 OpenAI 모델입니다. 개발사에 따르면 고품질 시각 자료를 일상적으로 빠르게 생성하는 것이 목적입니다. 지시에서 이야기, 스타일, 세부 요소의 배치, 원하는 화면 형태를 설명할 수 있으며 결과는 이미지입니다.

Ailoot의 이 카드는 텍스트 입력의 생성으로 표시되어 있습니다. OpenAI는 원본 이미지, 참고 자료, 수정 작업도 설명합니다. 이런 방식에는 입력 이미지 지원이 필요합니다. 텍스트 호출 방식이 이미 해당 자료를 입력받는다는 뜻은 아닙니다.

초안부터 상세한 이미지까지의 품질

low, medium, high, xhigh, max 수준과 자동 선택 auto를 지원합니다. 품질 설정은 결과를 구성하는 작업량에 영향을 줍니다. 화면 크기와 완성된 파일의 압축과는 별도로 지정합니다.

크기에는 정사각형, 가로형, 세로형, 자동 선택, 사용자 지정 크기가 있습니다. 개발사의 모든 제한을 지키면서 구도에 맞는 비율을 선택할 수 있습니다.

사용자 지정 크기

각 변은 16픽셀의 배수이며 3840픽셀 이하여야 합니다. 긴 변과 짧은 변의 비율은 최대 3:1입니다. 허용 면적은 655 360~8 294 400픽셀입니다. 제한은 함께 적용됩니다. 허용 화면 비율이 면적 제한을 없애지는 않습니다.

2560x1440보다 높은 해상도는 실험적인 것으로 표시되어 있습니다. 큰 화면을 선택할 때에는 구도 자체를 고려해야 합니다. 픽셀이 더 많다고 모든 요소가 오류 없이 배치되는 것은 아닙니다.

결과 파일과 투명도

모델은 PNG, JPEG, WebP를 제공하며 기본 형식은 PNG입니다. JPEG와 WebP에서는 압축을 조절할 수 있습니다. 투명 배경에는 PNG나 WebP가 필요합니다. 개발사는 불투명 배경과 자동 선택도 지원합니다. 투명도는 지정된 바탕 없이 이미지를 이후 구도에 사용할 수 있게 합니다.

개발사의 설정은 모델의 기능을 설명합니다. 실행은 선택한 호출 방식의 설정 지원에 따라 달라집니다. 개별 생성은 새로운 결과를 만드므로 같은 설명이 이미지의 완전한 일치를 보장하지는 않습니다.

완성된 이미지에서 확인할 점

OpenAI에 따르면 복잡한 지시 처리는 최대 2분이 걸릴 수 있습니다. 이는 개발사의 생성에 대한 설명이며 특정 애플리케이션에서 결과를 받을 때까지의 전체 시간을 보장하는 것은 아닙니다.

글자, 대상의 정확한 위치, 이미지 사이의 동일한 외형 유지는 확인해야 합니다. 별도로 지원되는 편집 작업의 마스크는 변경 방향을 정하며 엄격한 경계가 아닙니다. 텍스트 생성에서는 구도를 정확하게 설명하고 파일 자체의 보이는 세부 요소, 가독성, 지정한 이야기와의 일치 여부를 확인하는 것이 유용합니다.

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot · 이미지 POST /v1/images/generations

입력: text
출력: image
출력 형식: 이미지 파일

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 gpt-image-2.5-flare-2026-09-08	기본값—
필드`prompt`	유형`string`	요건필수	값과 한도 최소 길이: 1	기본값—
필드`n`	유형`integer`	요건선택 사항	값과 한도 최솟값: 1	기본값1
필드`response_format`	유형`string`	요건선택 사항	값과 한도 url, b64_json	기본값—
필드`stream`	유형`boolean`	요건선택 사항	값과 한도	기본값false
필드`size`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`quality`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`background`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`output_format`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`output_compression`	유형`integer`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`moderation`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`input_fidelity`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`style`	유형`string`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—
필드`partial_images`	유형`integer`	요건선택 사항	값과 한도 모델에 따라 다름	기본값—

입력 자료 조합

텍스트로 이미지 생성 · 필수: prompt

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`material_types`	명세text
매개변수`required`	명세model, prompt
매개변수`optional_controls`	명세null
매개변수`content_type`	명세application/json

수명 주기: 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}

메서드 형식과 ID는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다.

요금

Ailoot 메서드 요금

Ailoot 이미지POST /v1/images/generations

텍스트 입력: US$0.005 / 1K
입력, 이미지: US$0.008 / 1K tokens
출력, 이미지: US$0.03 / 1K tokens

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot · 이미지

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare-2026-09-08", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

from openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare-2026-09-08', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare-2026-09-08", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

결과 수신 및 저장

Ailoot · 이미지

반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

완료된 결과 모두 보관

완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.

모든 데이터 항목을 저장하세요. 각 b64_json을 디코딩하거나 반환된 모든 서명된 URL에서 가져오세요. 실제 MIME/바이트에 따라 파일 확장자를 선택하세요.

원래 응답을 확인해야 할 경우

이미지 생성 또는 편집 결과를 확인해야 하는 경우 최초 operation_id/X-Client-Request-ID와 반환된 결과 정보를 보관하세요. 실제 task_id 또는 asset_id 값으로 미디어 라이브러리에서 기존의 소유한 결과를 복구하세요. 생성/편집 요청을 다시 제출하거나 operation_id로 폴링 URL을 구성하지 마세요.

응답 필드

필드	유형
필드`created`	유형integer
필드`data[].url`	유형string
필드`data[].b64_json`	유형base64 string
필드`usage`	유형object

오류와 다음 단계

응답	조건	다음 단계
응답400 · `invalid_request_error`	조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음	다음 단계새 생성 요청 전에 표시된 필드를 수정하세요.
응답`server_error`	조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다	다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요.

별칭

모델 별칭

Ailoot gpt-image-2.5-flare-2026-09-08

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

관련 호출용 ID

gpt-image-2.5-flare-2026-09-08

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-flare-2026-09-08", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-flare-2026-09-08", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|gpt-image-2.5-flare-2026-09-08", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음", "http_status": 400, "recovery": "새 생성 요청 전에 표시된 필드를 수정하세요.", "type": "invalid_request_error" }, { "code": null, "condition": "반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다", "http_status": null, "recovery": "최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "이미지 생성 또는 편집 결과를 확인해야 하는 경우 최초 operation_id/X-Client-Request-ID와 반환된 결과 정보를 보관하세요. 실제 task_id 또는 asset_id 값으로 미디어 라이브러리에서 기존의 소유한 결과를 복구하세요. 생성/편집 요청을 다시 제출하거나 operation_id로 폴링 URL을 구성하지 마세요." }, "material_combinations": [ { "content_types": [ "application/json", "multipart/form-data" ], "file_id_supported": false, "mode": "text_to_image", "multipart_part_read_limit_bytes": 20971520, "optional_mask": { "json": "mask.image_url", "multipart": "mask" }, "reference_representations": { "json": "images[].image_url", "multipart": [ "image", "image[]", "image[index]" ] }, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "모든 데이터 항목을 저장하세요. 각 b64_json을 디코딩하거나 반환된 모든 서명된 URL에서 가져오세요. 실제 MIME/바이트에 따라 파일 확장자를 선택하세요.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "gpt-image-2.5-flare-2026-09-08" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "quality", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "background", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_format", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_compression", "required": false, "type": "integer" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "moderation", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_fidelity", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "style", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id" ] }, "hints": [ "메서드 형식과 ID는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "실제로 반환된 task_id 또는 미디어 라이브러리 기록", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: \"${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}\"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"gpt-image-2.5-flare-2026-09-08\", \"prompt\": \"\"}')\nf=Path(os.environ[\"AILOOT_PROMPT_FILE\"])\nif not f.is_file():raise SystemExit(\"Choose your actual UTF-8 brief\")\np['prompt']=f.read_text(encoding=\"utf-8\")\nif not p['prompt'].strip():raise SystemExit(\"Brief must contain text\")\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"