Grok Imagine Image 2.0 nhận mô tả cảnh và tạo ảnh. Mô hình xAI còn xử lý được tư liệu hình ảnh nguồn: áp dụng thay đổi theo chỉ dẫn văn bản và tiếp tục chỉnh sửa bằng kết quả trước làm đầu vào mới. Ailoot công bố phương thức tạo ảnh từ văn bản.
Với Image 2.0, xAI mô tả ảnh chụp chân thực, anime, tranh sơn dầu và vẽ chì. Phong cách được đặt bằng lời; khi xử lý ảnh nguồn, chỉ dẫn xác định thẩm mỹ mong muốn. Thay đổi tuần tự cho phép thêm chi tiết và điều chỉnh kết quả từng bước.
n đặt từ 1 đến 10 ảnh cho cùng mô tả; mặc định một ảnh.aspect_ratio chọn hình dạng khung; auto để mô hình lựa chọn.resolution đặt 1K hoặc 2K; giá trị tiêu chuẩn là 1K.Có định dạng vuông, ngang, dọc: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Các định dạng màn hình kéo dài gồm 19.5:9, 9:19.5, 20:9, 9:20, cùng định dạng rộng 21:9 và 5:2.
Image 2.0 hỗ trợ low, medium và auto. Tham số thuộc đúng phiên bản này; auto được dùng nếu không đặt chất lượng. Tại thời điểm kiểm tra, chế độ tự động chọn low khi tạo ảnh và medium khi chỉnh sửa.
Theo xAI, chế độ medium dành thêm tính toán để xử lý chi tiết ảnh. Chọn rõ low hoặc medium cố định chế độ cần thiết, còn hành vi auto phụ thuộc vào cài đặt hiện tại của nhà sản xuất.
Mô hình có đầu vào văn bản, hình ảnh và đầu ra ảnh. Trong chế độ chỉnh sửa riêng của xAI, Image 2.0 nhận tối đa năm ảnh nguồn; phương thức tạo ảnh Ailoot hiện tại sử dụng đầu vào văn bản. Kết quả có thể được truyền bằng tệp qua liên kết hoặc dạng base64.
", "aboutText": "### Tạo và điều chỉnh ảnh\n\nGrok Imagine Image 2.0 nhận mô tả cảnh và tạo ảnh. Mô hình xAI còn xử lý được tư liệu hình ảnh nguồn: áp dụng thay đổi theo chỉ dẫn văn bản và tiếp tục chỉnh sửa bằng kết quả trước làm đầu vào mới. Ailoot công bố phương thức tạo ảnh từ văn bản.\n\n### Phong cách hình ảnh\n\nVới Image 2.0, xAI mô tả ảnh chụp chân thực, anime, tranh sơn dầu và vẽ chì. Phong cách được đặt bằng lời; khi xử lý ảnh nguồn, chỉ dẫn xác định thẩm mỹ mong muốn. Thay đổi tuần tự cho phép thêm chi tiết và điều chỉnh kết quả từng bước.\n\n### Tỷ lệ, kích thước và số lượng\n\n- `n` đặt từ 1 đến 10 ảnh cho cùng mô tả; mặc định một ảnh.\n- `aspect_ratio` chọn hình dạng khung; `auto` để mô hình lựa chọn.\n- `resolution` đặt 1K hoặc 2K; giá trị tiêu chuẩn là 1K.\n\nCó định dạng vuông, ngang, dọc: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`. Các định dạng màn hình kéo dài gồm `19.5:9`, `9:19.5`, `20:9`, `9:20`, cùng định dạng rộng `21:9` và `5:2`.\n\n### Chọn chất lượng\n\nImage 2.0 hỗ trợ `low`, `medium` và `auto`. Tham số thuộc đúng phiên bản này; `auto` được dùng nếu không đặt chất lượng. Tại thời điểm kiểm tra, chế độ tự động chọn `low` khi tạo ảnh và `medium` khi chỉnh sửa.\n\nTheo xAI, chế độ `medium` dành thêm tính toán để xử lý chi tiết ảnh. Chọn rõ `low` hoặc `medium` cố định chế độ cần thiết, còn hành vi `auto` phụ thuộc vào cài đặt hiện tại của nhà sản xuất.\n\n### Đầu vào và kết quả\n\nMô hình có đầu vào văn bản, hình ảnh và đầu ra ảnh. Trong chế độ chỉnh sửa riêng của xAI, Image 2.0 nhận tối đa năm ảnh nguồn; phương thức tạo ảnh Ailoot hiện tại sử dụng đầu vào văn bản. Kết quả có thể được truyền bằng tệp qua liên kết hoặc dạng base64.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "300d5dea4c66f739b194333b9f19f5dbd4575160ac9287281ea3d4d47f4457fd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "grok-imagine-image-2.0Grok Imagine Image 2.0 tạo ảnh từ mô tả, cho phép chọn tỷ lệ, độ phân giải và chất lượng. Chính mô hình còn hỗ trợ chỉnh sửa ảnh và chuyển phong cách hình ảnh.
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Grok Imagine Image 2.0 nhận mô tả cảnh và tạo ảnh. Mô hình xAI còn xử lý được tư liệu hình ảnh nguồn: áp dụng thay đổi theo chỉ dẫn văn bản và tiếp tục chỉnh sửa bằng kết quả trước làm đầu vào mới. Ailoot công bố phương thức tạo ảnh từ văn bản.
Với Image 2.0, xAI mô tả ảnh chụp chân thực, anime, tranh sơn dầu và vẽ chì. Phong cách được đặt bằng lời; khi xử lý ảnh nguồn, chỉ dẫn xác định thẩm mỹ mong muốn. Thay đổi tuần tự cho phép thêm chi tiết và điều chỉnh kết quả từng bước.
n đặt từ 1 đến 10 ảnh cho cùng mô tả; mặc định một ảnh.aspect_ratio chọn hình dạng khung; auto để mô hình lựa chọn.resolution đặt 1K hoặc 2K; giá trị tiêu chuẩn là 1K.Có định dạng vuông, ngang, dọc: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Các định dạng màn hình kéo dài gồm 19.5:9, 9:19.5, 20:9, 9:20, cùng định dạng rộng 21:9 và 5:2.
Image 2.0 hỗ trợ low, medium và auto. Tham số thuộc đúng phiên bản này; auto được dùng nếu không đặt chất lượng. Tại thời điểm kiểm tra, chế độ tự động chọn low khi tạo ảnh và medium khi chỉnh sửa.
Theo xAI, chế độ medium dành thêm tính toán để xử lý chi tiết ảnh. Chọn rõ low hoặc medium cố định chế độ cần thiết, còn hành vi auto phụ thuộc vào cài đặt hiện tại của nhà sản xuất.
Mô hình có đầu vào văn bản, hình ảnh và đầu ra ảnh. Trong chế độ chỉnh sửa riêng của xAI, Image 2.0 nhận tối đa năm ảnh nguồn; phương thức tạo ảnh Ailoot hiện tại sử dụng đầu vào văn bản. Kết quả có thể được truyền bằng tệp qua liên kết hoặc dạng base64.
POST /v1/images/generationstextimage| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn grok-imagine-image-2.0 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 10 | Mặc định1 |
Trườngresponse_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn url, b64_json | Mặc địnhurl |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1k, 2k | Mặc định1k |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 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 | Mặc địnhauto |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn low, medium, auto | Mặc định— |
Văn bản thành ảnh · Bắt buộc: prompt
| Tham số | Hợp đồng |
|---|---|
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốoptional_controls | Hợp đồngnull |
Tham sốcontent_type | Hợp đồngapplication/json |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cấu trúc phương thức và ID là chính xác; khả năng của nhà cung cấp tách biệt với việc cho phép tiếp nhận yêu cầu.
POST /v1/images/generationsAiloot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
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");\nTải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Lưu mọi phần tử dữ liệu. Giải mã từng b64_json hoặc tải xuống từ mọi URL có chữ ký đã trả về. Chọn phần mở rộng tệp dựa trên MIME/nội dung byte thực tế.
Nếu kết quả tạo hoặc chỉnh sửa ảnh cần được kiểm tra, giữ lại operation_id/X-Client-Request-ID gốc và thông tin kết quả đã trả về. Khôi phục các kết quả hiện có thuộc quyền sở hữu của bạn qua thư viện nội dung đa phương tiện bằng các giá trị task_id hoặc asset_id thực tế. Không gửi lại yêu cầu tạo/chỉnh sửa ảnh hoặc tạo URL truy vấn trạng thái từ operation_id.
| Trường | Loại |
|---|---|
Trườngcreated | Loạiinteger |
Trườngdata[].url | Loạistring |
Trườngdata[].b64_json | Loạibase64 string |
Trườngusage | Loạiobject |
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Ailoot grok-imagine-image-2.0
Dùng các đường dẫn phương thức hiển thị ở trên.