Qwen-Image-3.0-Pro es un modelo de Alibaba para crear y editar imágenes en las que importan la composición, los textos y los detalles pequeños. Entre sus aplicaciones figuran composiciones densas, imágenes dentro de otras imágenes, maquetación de periódicos, guiones gráficos, menús y fichas educativas. La ficha actual de Ailoot presenta el modo de generación de imágenes a partir de texto. Alibaba también contempla edición e imágenes de referencia; esas operaciones requieren compatibilidad independiente con imágenes de entrada y no están incluidas en el método actual de la ficha.
El fabricante destaca instrucciones largas de hasta 4,5 mil tokens, textos en 12 idiomas y el uso de varias tipografías. Es una capacidad descrita para procesar instrucciones, no el tamaño publicado de una ventana formal de contexto. Entre las características anunciadas figuran textos pequeños de 10 píxeles, texturas de piel y cabello y cambios sutiles de expresión facial. Son detalles útiles para materiales que se observan de cerca.
Qwen-Image-3.0-Pro también está orientado a conceptos visuales de páginas web, juegos y pantallas de emisiones en directo. El resultado puede combinar ilustración, estructura de pantalla y textos con diseño. El modelo crea una imagen del diseño; una aplicación funcional requiere una implementación aparte.
Para el modo de edición, Alibaba indica entre una y tres imágenes. En ese método, el fabricante permite vincular un objeto al número de una referencia y describir cómo combinar los materiales. Se contempla añadir, eliminar y mover objetos, cambiar acciones, estilo, detalles y texto. Una descripción negativa ayuda a indicar elementos no deseados.
El modo de edición del fabricante admite JPG, JPEG, PNG, BMP, TIFF, WEBP y GIF. En un GIF animado se utiliza el primer fotograma. Cada archivo puede ocupar hasta 10 MB; el fabricante recomienda imágenes cuyos lados midan entre 384 y 3072 píxeles. Son recomendaciones para la entrada, no tamaños del resultado final.
La especificación del fabricante contempla entre una y seis imágenes de salida en PNG por solicitud. La superficie del resultado va de 262 144 a 4 194 304 píxeles, equivalente a imágenes cuadradas de 512 × 512 a 2048 × 2048. Se admiten relaciones de aspecto de 1:8 a 8:1, por lo que, en una composición alargada, la longitud del lado también depende del formato elegido. Se contempla un ajuste adicional de la instrucción antes de generar la imagen.
", "aboutText": "Qwen-Image-3.0-Pro es un modelo de Alibaba para crear y editar imágenes en las que importan la composición, los textos y los detalles pequeños. Entre sus aplicaciones figuran composiciones densas, imágenes dentro de otras imágenes, maquetación de periódicos, guiones gráficos, menús y fichas educativas. La ficha actual de Ailoot presenta el modo de generación de imágenes a partir de texto. Alibaba también contempla edición e imágenes de referencia; esas operaciones requieren compatibilidad independiente con imágenes de entrada y no están incluidas en el método actual de la ficha.\n\n### Texto y detalle dentro de la imagen\n\nEl fabricante destaca instrucciones largas de hasta 4,5 mil tokens, textos en 12 idiomas y el uso de varias tipografías. Es una capacidad descrita para procesar instrucciones, no el tamaño publicado de una ventana formal de contexto. Entre las características anunciadas figuran textos pequeños de 10 píxeles, texturas de piel y cabello y cambios sutiles de expresión facial. Son detalles útiles para materiales que se observan de cerca.\n\nQwen-Image-3.0-Pro también está orientado a conceptos visuales de páginas web, juegos y pantallas de emisiones en directo. El resultado puede combinar ilustración, estructura de pantalla y textos con diseño. El modelo crea una imagen del diseño; una aplicación funcional requiere una implementación aparte.\n\n### Edición en la especificación de Alibaba\n\nPara el modo de edición, Alibaba indica entre una y tres imágenes. En ese método, el fabricante permite vincular un objeto al número de una referencia y describir cómo combinar los materiales. Se contempla añadir, eliminar y mover objetos, cambiar acciones, estilo, detalles y texto. Una descripción negativa ayuda a indicar elementos no deseados.\n\nEl modo de edición del fabricante admite JPG, JPEG, PNG, BMP, TIFF, WEBP y GIF. En un GIF animado se utiliza el primer fotograma. Cada archivo puede ocupar hasta 10 MB; el fabricante recomienda imágenes cuyos lados midan entre 384 y 3072 píxeles. Son recomendaciones para la entrada, no tamaños del resultado final.\n\nLa especificación del fabricante contempla entre una y seis imágenes de salida en PNG por solicitud. La superficie del resultado va de 262 144 a 4 194 304 píxeles, equivalente a imágenes cuadradas de 512 × 512 a 2048 × 2048. Se admiten relaciones de aspecto de 1:8 a 8:1, por lo que, en una composición alargada, la longitud del lado también depende del formato elegido. Se contempla un ajuste adicional de la instrucción antes de generar la imagen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f89ce157107e581d4e10c86c12fed0751431c07c064e00a7f74afe5189144668", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "qwen-image-3.0-proModelo de generación de imágenes a partir de texto, centrado en composiciones complejas, textos y detalles realistas. Adecuado para carteles, guiones gráficos, menús y materiales con una composición densa.
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.
Qwen-Image-3.0-Pro es un modelo de Alibaba para crear y editar imágenes en las que importan la composición, los textos y los detalles pequeños. Entre sus aplicaciones figuran composiciones densas, imágenes dentro de otras imágenes, maquetación de periódicos, guiones gráficos, menús y fichas educativas. La ficha actual de Ailoot presenta el modo de generación de imágenes a partir de texto. Alibaba también contempla edición e imágenes de referencia; esas operaciones requieren compatibilidad independiente con imágenes de entrada y no están incluidas en el método actual de la ficha.
El fabricante destaca instrucciones largas de hasta 4,5 mil tokens, textos en 12 idiomas y el uso de varias tipografías. Es una capacidad descrita para procesar instrucciones, no el tamaño publicado de una ventana formal de contexto. Entre las características anunciadas figuran textos pequeños de 10 píxeles, texturas de piel y cabello y cambios sutiles de expresión facial. Son detalles útiles para materiales que se observan de cerca.
Qwen-Image-3.0-Pro también está orientado a conceptos visuales de páginas web, juegos y pantallas de emisiones en directo. El resultado puede combinar ilustración, estructura de pantalla y textos con diseño. El modelo crea una imagen del diseño; una aplicación funcional requiere una implementación aparte.
Para el modo de edición, Alibaba indica entre una y tres imágenes. En ese método, el fabricante permite vincular un objeto al número de una referencia y describir cómo combinar los materiales. Se contempla añadir, eliminar y mover objetos, cambiar acciones, estilo, detalles y texto. Una descripción negativa ayuda a indicar elementos no deseados.
El modo de edición del fabricante admite JPG, JPEG, PNG, BMP, TIFF, WEBP y GIF. En un GIF animado se utiliza el primer fotograma. Cada archivo puede ocupar hasta 10 MB; el fabricante recomienda imágenes cuyos lados midan entre 384 y 3072 píxeles. Son recomendaciones para la entrada, no tamaños del resultado final.
La especificación del fabricante contempla entre una y seis imágenes de salida en PNG por solicitud. La superficie del resultado va de 262 144 a 4 194 304 píxeles, equivalente a imágenes cuadradas de 512 × 512 a 2048 × 2048. Se admiten relaciones de aspecto de 1:8 a 8:1, por lo que, en una composición alargada, la longitud del lado también depende del formato elegido. Se contempla un ajuste adicional de la instrucción antes de generar la imagen.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites qwen-image-3.0-pro | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Camposize | Tipostring | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campopartial_images | Tipointeger | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campoimages[].image_url | Tipostring | RequisitoNo compatible | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Máximo de imágenes por matriz: 3 Condiciones: Una URL real por objeto images[]. El número de elementos de la lista es distinto de este valor final de tipo cadena. Se aplica cuando: Solo JSON images/edits; JSON images/generations no analiza las referencias images. | Predeterminado— |
Campoimage | Tipofile | RequisitoOpcional | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Campoimage[] | Tipofile[] | RequisitoOpcional | Valores y límites Número máximo de elementos: 3 Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Texto a imagen · Obligatorio: prompt
reference_images_generation · 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": "qwen-image-3.0-pro", "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': 'qwen-image-3.0-pro', '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": "qwen-image-3.0-pro", "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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Usa las rutas de método indicadas arriba.
qwen-imageModelo de generación de imágenes a partir de texto, centrado en composiciones complejas, textos y detalles realistas. Adecuado para carteles, guiones gráficos, menús y materiales con una composición densa.
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.
Qwen-Image-3.0-Pro es un modelo de Alibaba para crear y editar imágenes en las que importan la composición, los textos y los detalles pequeños. Entre sus aplicaciones figuran composiciones densas, imágenes dentro de otras imágenes, maquetación de periódicos, guiones gráficos, menús y fichas educativas. La ficha actual de Ailoot presenta el modo de generación de imágenes a partir de texto. Alibaba también contempla edición e imágenes de referencia; esas operaciones requieren compatibilidad independiente con imágenes de entrada y no están incluidas en el método actual de la ficha.
El fabricante destaca instrucciones largas de hasta 4,5 mil tokens, textos en 12 idiomas y el uso de varias tipografías. Es una capacidad descrita para procesar instrucciones, no el tamaño publicado de una ventana formal de contexto. Entre las características anunciadas figuran textos pequeños de 10 píxeles, texturas de piel y cabello y cambios sutiles de expresión facial. Son detalles útiles para materiales que se observan de cerca.
Qwen-Image-3.0-Pro también está orientado a conceptos visuales de páginas web, juegos y pantallas de emisiones en directo. El resultado puede combinar ilustración, estructura de pantalla y textos con diseño. El modelo crea una imagen del diseño; una aplicación funcional requiere una implementación aparte.
Para el modo de edición, Alibaba indica entre una y tres imágenes. En ese método, el fabricante permite vincular un objeto al número de una referencia y describir cómo combinar los materiales. Se contempla añadir, eliminar y mover objetos, cambiar acciones, estilo, detalles y texto. Una descripción negativa ayuda a indicar elementos no deseados.
El modo de edición del fabricante admite JPG, JPEG, PNG, BMP, TIFF, WEBP y GIF. En un GIF animado se utiliza el primer fotograma. Cada archivo puede ocupar hasta 10 MB; el fabricante recomienda imágenes cuyos lados midan entre 384 y 3072 píxeles. Son recomendaciones para la entrada, no tamaños del resultado final.
La especificación del fabricante contempla entre una y seis imágenes de salida en PNG por solicitud. La superficie del resultado va de 262 144 a 4 194 304 píxeles, equivalente a imágenes cuadradas de 512 × 512 a 2048 × 2048. Se admiten relaciones de aspecto de 1:8 a 8:1, por lo que, en una composición alargada, la longitud del lado también depende del formato elegido. Se contempla un ajuste adicional de la instrucción antes de generar la imagen.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites qwen-image | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Camposize | Tipostring | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campopartial_images | Tipointeger | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campoimages[].image_url | Tipostring | RequisitoNo compatible | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Máximo de imágenes por matriz: 3 Condiciones: Una URL real por objeto images[]. El número de elementos de la lista es distinto de este valor final de tipo cadena. Se aplica cuando: Solo JSON images/edits; JSON images/generations no analiza las referencias images. | Predeterminado— |
Campoimage | Tipofile | RequisitoOpcional | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Campoimage[] | Tipofile[] | RequisitoOpcional | Valores y límites Número máximo de elementos: 3 Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Texto a imagen · Obligatorio: prompt
reference_images_generation · 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": "qwen-image", "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': 'qwen-image', '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": "qwen-image", "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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Usa las rutas de método indicadas arriba.
qwen-image-latestModelo de generación de imágenes a partir de texto, centrado en composiciones complejas, textos y detalles realistas. Adecuado para carteles, guiones gráficos, menús y materiales con una composición densa.
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.
Qwen-Image-3.0-Pro es un modelo de Alibaba para crear y editar imágenes en las que importan la composición, los textos y los detalles pequeños. Entre sus aplicaciones figuran composiciones densas, imágenes dentro de otras imágenes, maquetación de periódicos, guiones gráficos, menús y fichas educativas. La ficha actual de Ailoot presenta el modo de generación de imágenes a partir de texto. Alibaba también contempla edición e imágenes de referencia; esas operaciones requieren compatibilidad independiente con imágenes de entrada y no están incluidas en el método actual de la ficha.
El fabricante destaca instrucciones largas de hasta 4,5 mil tokens, textos en 12 idiomas y el uso de varias tipografías. Es una capacidad descrita para procesar instrucciones, no el tamaño publicado de una ventana formal de contexto. Entre las características anunciadas figuran textos pequeños de 10 píxeles, texturas de piel y cabello y cambios sutiles de expresión facial. Son detalles útiles para materiales que se observan de cerca.
Qwen-Image-3.0-Pro también está orientado a conceptos visuales de páginas web, juegos y pantallas de emisiones en directo. El resultado puede combinar ilustración, estructura de pantalla y textos con diseño. El modelo crea una imagen del diseño; una aplicación funcional requiere una implementación aparte.
Para el modo de edición, Alibaba indica entre una y tres imágenes. En ese método, el fabricante permite vincular un objeto al número de una referencia y describir cómo combinar los materiales. Se contempla añadir, eliminar y mover objetos, cambiar acciones, estilo, detalles y texto. Una descripción negativa ayuda a indicar elementos no deseados.
El modo de edición del fabricante admite JPG, JPEG, PNG, BMP, TIFF, WEBP y GIF. En un GIF animado se utiliza el primer fotograma. Cada archivo puede ocupar hasta 10 MB; el fabricante recomienda imágenes cuyos lados midan entre 384 y 3072 píxeles. Son recomendaciones para la entrada, no tamaños del resultado final.
La especificación del fabricante contempla entre una y seis imágenes de salida en PNG por solicitud. La superficie del resultado va de 262 144 a 4 194 304 píxeles, equivalente a imágenes cuadradas de 512 × 512 a 2048 × 2048. Se admiten relaciones de aspecto de 1:8 a 8:1, por lo que, en una composición alargada, la longitud del lado también depende del formato elegido. Se contempla un ajuste adicional de la instrucción antes de generar la imagen.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites qwen-image-latest | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Camposize | Tipostring | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campopartial_images | Tipointeger | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— |
Campoimages[].image_url | Tipostring | RequisitoNo compatible | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Máximo de imágenes por matriz: 3 Condiciones: Una URL real por objeto images[]. El número de elementos de la lista es distinto de este valor final de tipo cadena. Se aplica cuando: Solo JSON images/edits; JSON images/generations no analiza las referencias images. | Predeterminado— |
Campoimage | Tipofile | RequisitoOpcional | Valores y límites Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Campoimage[] | Tipofile[] | RequisitoOpcional | Valores y límites Número máximo de elementos: 3 Máximo de bytes decodificados: 10.485.760 Tipos MIME: image/png, image/jpeg Se aplica cuando: generación mediante multipart/form-data | Predeterminado— |
Texto a imagen · Obligatorio: prompt
reference_images_generation · 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": "qwen-image-latest", "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': 'qwen-image-latest', '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": "qwen-image-latest", "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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Usa las rutas de método indicadas arriba.