Grok Imagine Image 2.0 recibe una descripción de la escena y crea una imagen. El modelo de xAI también puede trabajar con material visual original: aplicar cambios siguiendo instrucciones de texto y continuar la edición utilizando el resultado anterior como nueva entrada. En Ailoot está publicado el método de generación a partir de texto.
Para Image 2.0, xAI describe fotografía realista, anime, pintura al óleo y dibujo a lápiz. El estilo se define con palabras; al trabajar con una imagen original, las instrucciones determinan la estética deseada. Los cambios sucesivos permiten añadir detalles y precisar el resultado paso a paso.
n define entre 1 y 10 imágenes a partir de una descripción; el valor predeterminado es una.aspect_ratio selecciona las proporciones de la imagen; auto deja la elección al modelo.resolution define 1K o 2K; el valor predeterminado es 1K.Se contemplan formatos cuadrados, horizontales y verticales: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1 y 1:2. También hay formatos para pantallas alargadas, 19.5:9, 9:19.5, 20:9 y 9:20, y panorámicos, 21:9 y 5:2.
Image 2.0 admite low, medium y auto. El parámetro corresponde específicamente a esta versión; auto se utiliza cuando no se indica la calidad. En la fecha de comprobación, el modo automático elige low para generación y medium para edición.
Según xAI, el modo medium dedica más cómputo al detalle de la imagen. Elegir explícitamente low o medium fija el modo deseado, mientras que el comportamiento de auto depende de la configuración actual del fabricante.
El modelo dispone de entrada de texto y visual, y devuelve imágenes. En su propio modo de edición, xAI Image 2.0 acepta hasta cinco imágenes originales; el método actual de generación de Ailoot utiliza entrada de texto. El resultado puede transmitirse como archivo mediante un enlace o en base64.
", "aboutText": "### Generación y ajuste de imágenes\n\nGrok Imagine Image 2.0 recibe una descripción de la escena y crea una imagen. El modelo de xAI también puede trabajar con material visual original: aplicar cambios siguiendo instrucciones de texto y continuar la edición utilizando el resultado anterior como nueva entrada. En Ailoot está publicado el método de generación a partir de texto.\n\n### Estilos visuales\n\nPara Image 2.0, xAI describe fotografía realista, anime, pintura al óleo y dibujo a lápiz. El estilo se define con palabras; al trabajar con una imagen original, las instrucciones determinan la estética deseada. Los cambios sucesivos permiten añadir detalles y precisar el resultado paso a paso.\n\n### Proporciones, tamaño y cantidad\n\n- `n` define entre 1 y 10 imágenes a partir de una descripción; el valor predeterminado es una.\n- `aspect_ratio` selecciona las proporciones de la imagen; `auto` deja la elección al modelo.\n- `resolution` define 1K o 2K; el valor predeterminado es 1K.\n\nSe contemplan formatos cuadrados, horizontales y verticales: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1` y `1:2`. También hay formatos para pantallas alargadas, `19.5:9`, `9:19.5`, `20:9` y `9:20`, y panorámicos, `21:9` y `5:2`.\n\n### Elección de calidad\n\nImage 2.0 admite `low`, `medium` y `auto`. El parámetro corresponde específicamente a esta versión; `auto` se utiliza cuando no se indica la calidad. En la fecha de comprobación, el modo automático elige `low` para generación y `medium` para edición.\n\nSegún xAI, el modo `medium` dedica más cómputo al detalle de la imagen. Elegir explícitamente `low` o `medium` fija el modo deseado, mientras que el comportamiento de `auto` depende de la configuración actual del fabricante.\n\n### Entrada y resultado\n\nEl modelo dispone de entrada de texto y visual, y devuelve imágenes. En su propio modo de edición, xAI Image 2.0 acepta hasta cinco imágenes originales; el método actual de generación de Ailoot utiliza entrada de texto. El resultado puede transmitirse como archivo mediante un enlace o en base64.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e7cd0edfd80beaa037873c0f398c96e4f9b3910dcaab6049f087abb7c783a57a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "grok-imagine-image-2.0Grok Imagine Image 2.0 crea imágenes a partir de descripciones y permite elegir las proporciones, la resolución y la calidad. El propio modelo también admite edición de imágenes y transferencia de estilo visual.
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Grok Imagine Image 2.0 recibe una descripción de la escena y crea una imagen. El modelo de xAI también puede trabajar con material visual original: aplicar cambios siguiendo instrucciones de texto y continuar la edición utilizando el resultado anterior como nueva entrada. En Ailoot está publicado el método de generación a partir de texto.
Para Image 2.0, xAI describe fotografía realista, anime, pintura al óleo y dibujo a lápiz. El estilo se define con palabras; al trabajar con una imagen original, las instrucciones determinan la estética deseada. Los cambios sucesivos permiten añadir detalles y precisar el resultado paso a paso.
n define entre 1 y 10 imágenes a partir de una descripción; el valor predeterminado es una.aspect_ratio selecciona las proporciones de la imagen; auto deja la elección al modelo.resolution define 1K o 2K; el valor predeterminado es 1K.Se contemplan formatos cuadrados, horizontales y verticales: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1 y 1:2. También hay formatos para pantallas alargadas, 19.5:9, 9:19.5, 20:9 y 9:20, y panorámicos, 21:9 y 5:2.
Image 2.0 admite low, medium y auto. El parámetro corresponde específicamente a esta versión; auto se utiliza cuando no se indica la calidad. En la fecha de comprobación, el modo automático elige low para generación y medium para edición.
Según xAI, el modo medium dedica más cómputo al detalle de la imagen. Elegir explícitamente low o medium fija el modo deseado, mientras que el comportamiento de auto depende de la configuración actual del fabricante.
El modelo dispone de entrada de texto y visual, y devuelve imágenes. En su propio modo de edición, xAI Image 2.0 acepta hasta cinco imágenes originales; el método actual de generación de Ailoot utiliza entrada de texto. El resultado puede transmitirse como archivo mediante un enlace o en base64.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites grok-imagine-image-2.0 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 10 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminadourl |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 1k, 2k | Predeterminado1k |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 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 | Predeterminadoauto |
Campoquality | Tipostring | RequisitoOpcional | Valores y límites low, medium, auto | Predeterminado— |
Texto a imagen · Obligatorio: prompt
| Parámetro | Contrato |
|---|---|
Parámetromaterial_types | Contratotext |
Parámetrorequired | Contratomodel, prompt |
Parámetrooptional_controls | Contratonull |
Parámetrocontent_type | Contratoapplication/json |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id real devuelto o registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.
POST /v1/images/generationsAiloot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidació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");\nDescarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Guarda todos los elementos de datos. Decodifica cada b64_json o descarga el recurso de cada URL firmada devuelta. Elige la extensión del archivo a partir del tipo MIME o de los bytes reales.
Si el resultado de una generación o edición de imágenes requiere una comprobación, conserva el operation_id/X-Client-Request-ID original y la información del resultado devuelta. Recupera los resultados propios existentes a través de la biblioteca multimedia usando valores task_id o asset_id reales. No vuelvas a enviar la solicitud de generación o edición ni construyas una URL de consulta periódica a partir de operation_id.
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una comprobación | Siguiente pasoConserva el ID original de operación o tarea devuelto, las cabeceras de la solicitud y la respuesta; continúa con las lecturas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot grok-imagine-image-2.0
Usa las rutas de método indicadas arriba.