Grok Imagine Image 2.0은 장면 설명을 입력받고 이미지를 만듭니다. xAI 모델은 원본 시각 자료도 처리할 수 있습니다. 텍스트 지시로 변경을 적용하고 이전 결과를 새 입력으로 사용해 편집을 이어갑니다. Ailoot에는 텍스트 생성 호출 방식이 공개되어 있습니다.
Image 2.0에 대해 xAI는 사실적인 사진, 애니메이션, 유화, 연필 그림을 설명합니다. 스타일은 말로 지정합니다. 원본 이미지를 사용할 때 지시는 원하는 미감을 정합니다. 순차적인 변경으로 세부 사항을 추가하고 결과를 단계적으로 구체화할 수 있습니다.
n은 하나의 설명으로 만들 이미지 1~10개를 정하며, 기본은 하나입니다.aspect_ratio는 화면 형태를 선택하고 auto는 모델이 선택하게 합니다.resolution은 1K 또는 2K를 정하며 기본값은 1K입니다.정사각형, 가로형, 세로형 비율 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2를 제공합니다. 길쭉한 화면 비율 19.5:9, 9:19.5, 20:9, 9:20과 넓은 21:9, 5:2도 있습니다.
Image 2.0은 low, medium, auto를 지원합니다. 이 설정은 해당 버전에 적용됩니다. 품질을 지정하지 않으면 auto를 사용합니다. 확인 당시 자동 모드는 생성에서 low, 편집에서 medium을 선택합니다.
xAI에 따르면 medium은 이미지의 상세 표현에 더 많은 계산을 배정합니다. low나 medium을 명시적으로 선택하면 필요한 모드를 고정하고, auto의 동작은 개발사의 현재 설정에 따라 정해집니다.
모델에는 텍스트 입력과 시각 입력이 있으며 결과는 이미지입니다. xAI Image 2.0의 자체 편집 모드는 원본 이미지 최대 다섯 개를 입력받습니다. 현재 Ailoot 생성 호출 방식은 텍스트 입력을 사용합니다. 결과는 링크의 파일이나 base64로 전달할 수 있습니다.
", "aboutText": "### 이미지 생성과 구체화\n\nGrok Imagine Image 2.0은 장면 설명을 입력받고 이미지를 만듭니다. xAI 모델은 원본 시각 자료도 처리할 수 있습니다. 텍스트 지시로 변경을 적용하고 이전 결과를 새 입력으로 사용해 편집을 이어갑니다. Ailoot에는 텍스트 생성 호출 방식이 공개되어 있습니다.\n\n### 시각적 스타일\n\nImage 2.0에 대해 xAI는 사실적인 사진, 애니메이션, 유화, 연필 그림을 설명합니다. 스타일은 말로 지정합니다. 원본 이미지를 사용할 때 지시는 원하는 미감을 정합니다. 순차적인 변경으로 세부 사항을 추가하고 결과를 단계적으로 구체화할 수 있습니다.\n\n### 비율, 크기, 수량\n\n- `n`은 하나의 설명으로 만들 이미지 1~10개를 정하며, 기본은 하나입니다.\n- `aspect_ratio`는 화면 형태를 선택하고 `auto`는 모델이 선택하게 합니다.\n- `resolution`은 1K 또는 2K를 정하며 기본값은 1K입니다.\n\n정사각형, 가로형, 세로형 비율 `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`를 제공합니다. 길쭉한 화면 비율 `19.5:9`, `9:19.5`, `20:9`, `9:20`과 넓은 `21:9`, `5:2`도 있습니다.\n\n### 품질 선택\n\nImage 2.0은 `low`, `medium`, `auto`를 지원합니다. 이 설정은 해당 버전에 적용됩니다. 품질을 지정하지 않으면 `auto`를 사용합니다. 확인 당시 자동 모드는 생성에서 `low`, 편집에서 `medium`을 선택합니다.\n\nxAI에 따르면 `medium`은 이미지의 상세 표현에 더 많은 계산을 배정합니다. `low`나 `medium`을 명시적으로 선택하면 필요한 모드를 고정하고, `auto`의 동작은 개발사의 현재 설정에 따라 정해집니다.\n\n### 입력과 결과\n\n모델에는 텍스트 입력과 시각 입력이 있으며 결과는 이미지입니다. xAI Image 2.0의 자체 편집 모드는 원본 이미지 최대 다섯 개를 입력받습니다. 현재 Ailoot 생성 호출 방식은 텍스트 입력을 사용합니다. 결과는 링크의 파일이나 base64로 전달할 수 있습니다.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "daa74a70cffc901d1a5934323e6705a52f5e16e2fa309578e72a628887f17384", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ko", "methods": [ { "html": "grok-imagine-image-2.0Grok Imagine Image 2.0은 설명으로 이미지를 만들며 비율, 해상도, 품질을 선택할 수 있습니다. 모델 자체는 이미지 편집과 시각적 스타일 변환도 지원합니다.
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Grok Imagine Image 2.0은 장면 설명을 입력받고 이미지를 만듭니다. xAI 모델은 원본 시각 자료도 처리할 수 있습니다. 텍스트 지시로 변경을 적용하고 이전 결과를 새 입력으로 사용해 편집을 이어갑니다. Ailoot에는 텍스트 생성 호출 방식이 공개되어 있습니다.
Image 2.0에 대해 xAI는 사실적인 사진, 애니메이션, 유화, 연필 그림을 설명합니다. 스타일은 말로 지정합니다. 원본 이미지를 사용할 때 지시는 원하는 미감을 정합니다. 순차적인 변경으로 세부 사항을 추가하고 결과를 단계적으로 구체화할 수 있습니다.
n은 하나의 설명으로 만들 이미지 1~10개를 정하며, 기본은 하나입니다.aspect_ratio는 화면 형태를 선택하고 auto는 모델이 선택하게 합니다.resolution은 1K 또는 2K를 정하며 기본값은 1K입니다.정사각형, 가로형, 세로형 비율 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2를 제공합니다. 길쭉한 화면 비율 19.5:9, 9:19.5, 20:9, 9:20과 넓은 21:9, 5:2도 있습니다.
Image 2.0은 low, medium, auto를 지원합니다. 이 설정은 해당 버전에 적용됩니다. 품질을 지정하지 않으면 auto를 사용합니다. 확인 당시 자동 모드는 생성에서 low, 편집에서 medium을 선택합니다.
xAI에 따르면 medium은 이미지의 상세 표현에 더 많은 계산을 배정합니다. low나 medium을 명시적으로 선택하면 필요한 모드를 고정하고, auto의 동작은 개발사의 현재 설정에 따라 정해집니다.
모델에는 텍스트 입력과 시각 입력이 있으며 결과는 이미지입니다. xAI Image 2.0의 자체 편집 모드는 원본 이미지 최대 다섯 개를 입력받습니다. 현재 Ailoot 생성 호출 방식은 텍스트 입력을 사용합니다. 결과는 링크의 파일이나 base64로 전달할 수 있습니다.
POST /v1/images/generationstextimage| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 grok-imagine-image-2.0 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 최댓값: 10 | 기본값1 |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 url, b64_json | 기본값url |
필드resolution | 유형string | 요건선택 사항 | 값과 한도 1k, 2k | 기본값1k |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9, 5:2 | 기본값auto |
필드quality | 유형string | 요건선택 사항 | 값과 한도 low, medium, auto | 기본값— |
텍스트로 이미지 생성 · 필수: 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는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다.
POST /v1/images/generationsAiloot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
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": "grok-imagine-image-2.0", "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\nfrom 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': 'grok-imagine-image-2.0', '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])\nimport 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": "grok-imagine-image-2.0", "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반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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 grok-imagine-image-2.0
위에 표시된 메서드 경로를 사용하세요.