Una edición más rápida de creación de imágenes
Seedream 5.0 Flash es el modelo de generación y edición de imágenes de ByteDance Seed para flujos que priorizan la velocidad de generación. La guía Pro/Flash del fabricante describe tanto creación de texto a imagen como de imagen a imagen con una o varias referencias. Distingue la generación más rápida de Flash de la mayor prioridad de calidad de imagen de Pro, sin establecer un tiempo fijo de respuesta para cada brief.
Las funciones compartidas distintivas son edición interactiva, descomposición en capas y generación multilingüe nativa. La generación habitual devuelve una imagen terminada. El flujo Flash del fabricante no admite generación secuencial de imágenes relacionadas, búsqueda web ni salida de imágenes en streaming. Su optimización de prompts utiliza el modo estándar; el control independiente de optimización rápida pertenece a Pro, no a Flash.
Creación a partir de un brief y referencias
Indica la imagen prevista, el sujeto principal, la composición y el tratamiento visual; después identifica qué controla cada referencia. Para una imagen de producto, separa la referencia que establece el objeto de otra que aporta una paleta o material superficial. “Conserva la silueta y el ángulo de vista del objeto de la primera imagen; utiliza la segunda únicamente para la paleta apagada del fondo” asigna funciones distintas a las referencias.
El fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras en inglés. Es orientación de preparación, no un límite estricto declarado de entrada de texto. Enumera primero los requisitos decisivos, incluido el texto exacto que debe aparecer, la relación de aspecto deseada y los detalles que deben permanecer sin cambios. Revisa la imagen terminada frente a esa lista en lugar de depender solamente de su apariencia general.
Edición guiada espacialmente
Flash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe hacerse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interiores, marca la silla, solicita una sustitución de tela e identifica el piso, la pared, el ángulo de cámara y los objetos cercanos que deben conservarse. Si las marcas solo sirven como guía, pide explícitamente que se eliminen de la imagen terminada.
La guía de edición por coordenadas del fabricante utiliza etiquetas <point> y <bbox> con coordenadas normalizadas de 0 a 999 respecto a la imagen de entrada especificada. Un punto contiene las coordenadas x e y; un cuadro contiene las coordenadas superior izquierda e inferior derecha. Identifica el número de imagen y el objeto que se debe editar, especialmente cuando un cuadro incluye varios sujetos. Para una edición entre imágenes, distingue el objeto que se tomará de una referencia y la zona de destino en otra.
Utiliza las propias dimensiones de la imagen mostrada al obtener la ubicación proporcional; el zoom del lienzo, el desplazamiento o las coordenadas del navegador no son las coordenadas normalizadas de la imagen. Describe las zonas protegidas además de la zona editada. Compara la perspectiva, la iluminación y los detalles circundantes del resultado con la fuente original.
Separa una composición en capas editables
La descomposición en capas es un modo distinto que toma exactamente una imagen y devuelve una imagen base más hasta 16 capas independientes. Cada capa es un PNG con alfa. Un prompt puede nombrar los elementos que deben separarse, como título, sujeto principal y decoraciones; sin un prompt de descomposición, el modelo identifica automáticamente los elementos principales.
Los resultados incluyen nombres de capas, descripciones, orden de apilamiento y cuadros de ubicación. Utiliza la imagen base con índice de apilamiento cero y después coloca las otras capas en orden ascendente de apilamiento. Los cuadros absolutos describen la ubicación en la imagen base de salida; los cuadros normalizados describen la ubicación proporcional en otro lienzo. Conserva estos metadatos de ubicación devueltos con los archivos de imagen para reconstruir la composición original antes de reorganizarla.
Para una revisión de cartel, separa la ilustración principal del título y las decoraciones; después revisa los bordes y cualquier zona restaurada del fondo. Una capa transparente puede editarse como una sola entrada con canal alfa y salida PNG transparente. La opción de fondo transparente se limita a ese flujo de edición con una sola imagen de entrada; la generación habitual de texto a imagen es una operación independiente.
Composición multilingüe
Además de chino e inglés, el fabricante documenta compatibilidad nativa de prompts y texto en imágenes con ruso, árabe, filipino, tailandés, turco, coreano, malayo, español, portugués, indonesio, francés, alemán, vietnamita y japonés. Proporciona el texto aprobado exacto y la dirección de lectura, e identifica qué zona contiene cada bloque de texto. Revisa acentos, caracteres unidos, saltos de línea y etiquetas pequeñas en la imagen final.
Archivos de referencia y especificaciones de salida
La generación de imágenes admite hasta 10 referencias en JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Cada una puede tener hasta 30 MB, con ambos lados superiores a 14 píxeles, entre 196 y 36,000,000 píxeles totales y una relación de aspecto de 1:16 a 16:1. La descomposición en capas requiere en cambio un JPEG o PNG de entre 262,144 y 36,000,000 píxeles, de hasta 30 MB y dentro del mismo rango de proporciones.
La generación ofrece niveles de salida 1K, 1.5K y 2K, con 2K como predeterminado, o dimensiones explícitas con entre 921,600 y 4,624,220 píxeles totales y proporciones de 1:16 a 16:1. Ambas restricciones se aplican a las dimensiones personalizadas. La salida de capas utiliza 1K, 1.5K, 2K o auto, con auto como valor predeterminado; la base y cada capa conservan sus respectivas relaciones de aspecto de origen.
Las imágenes terminadas son JPEG o PNG. El formato de la imagen base puede seleccionarse por separado, mientras que las capas descompuestas siguen siendo PNG con alfa. La entrega puede utilizar datos de imagen codificados o enlaces de descarga conservados durante 24 horas. Guarda cada imagen devuelta y sus metadatos para el flujo de diseño previsto. Revisa texto, detalles editados y alineación de capas al tamaño en que se utilizará el material gráfico.
", "aboutText": "Una edición más rápida de creación de imágenes\n\nSeedream 5.0 Flash es el modelo de generación y edición de imágenes de ByteDance Seed para flujos que priorizan la velocidad de generación. La guía Pro/Flash del fabricante describe tanto creación de texto a imagen como de imagen a imagen con una o varias referencias. Distingue la generación más rápida de Flash de la mayor prioridad de calidad de imagen de Pro, sin establecer un tiempo fijo de respuesta para cada brief.\n\nLas funciones compartidas distintivas son edición interactiva, descomposición en capas y generación multilingüe nativa. La generación habitual devuelve una imagen terminada. El flujo Flash del fabricante no admite generación secuencial de imágenes relacionadas, búsqueda web ni salida de imágenes en streaming. Su optimización de prompts utiliza el modo estándar; el control independiente de optimización rápida pertenece a Pro, no a Flash.\n\nCreación a partir de un brief y referencias\n\nIndica la imagen prevista, el sujeto principal, la composición y el tratamiento visual; después identifica qué controla cada referencia. Para una imagen de producto, separa la referencia que establece el objeto de otra que aporta una paleta o material superficial. “Conserva la silueta y el ángulo de vista del objeto de la primera imagen; utiliza la segunda únicamente para la paleta apagada del fondo” asigna funciones distintas a las referencias.\n\nEl fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras en inglés. Es orientación de preparación, no un límite estricto declarado de entrada de texto. Enumera primero los requisitos decisivos, incluido el texto exacto que debe aparecer, la relación de aspecto deseada y los detalles que deben permanecer sin cambios. Revisa la imagen terminada frente a esa lista en lugar de depender solamente de su apariencia general.\n\nEdición guiada espacialmente\n\nFlash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe hacerse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interiores, marca la silla, solicita una sustitución de tela e identifica el piso, la pared, el ángulo de cámara y los objetos cercanos que deben conservarse. Si las marcas solo sirven como guía, pide explícitamente que se eliminen de la imagen terminada.\n\nLa guía de edición por coordenadas del fabricante utiliza etiquetasbytedance-seed/seedream-5-0-flashCrea una imagen terminada a partir de una descripción escrita.
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.
Una edición más rápida de creación de imágenes
Seedream 5.0 Flash es el modelo de generación y edición de imágenes de ByteDance Seed para flujos que priorizan la velocidad de generación. La guía Pro/Flash del fabricante describe tanto creación de texto a imagen como de imagen a imagen con una o varias referencias. Distingue la generación más rápida de Flash de la mayor prioridad de calidad de imagen de Pro, sin establecer un tiempo fijo de respuesta para cada brief.
Las funciones compartidas distintivas son edición interactiva, descomposición en capas y generación multilingüe nativa. La generación habitual devuelve una imagen terminada. El flujo Flash del fabricante no admite generación secuencial de imágenes relacionadas, búsqueda web ni salida de imágenes en streaming. Su optimización de prompts utiliza el modo estándar; el control independiente de optimización rápida pertenece a Pro, no a Flash.
Creación a partir de un brief y referencias
Indica la imagen prevista, el sujeto principal, la composición y el tratamiento visual; después identifica qué controla cada referencia. Para una imagen de producto, separa la referencia que establece el objeto de otra que aporta una paleta o material superficial. “Conserva la silueta y el ángulo de vista del objeto de la primera imagen; utiliza la segunda únicamente para la paleta apagada del fondo” asigna funciones distintas a las referencias.
El fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras en inglés. Es orientación de preparación, no un límite estricto declarado de entrada de texto. Enumera primero los requisitos decisivos, incluido el texto exacto que debe aparecer, la relación de aspecto deseada y los detalles que deben permanecer sin cambios. Revisa la imagen terminada frente a esa lista en lugar de depender solamente de su apariencia general.
Edición guiada espacialmente
Flash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe hacerse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interiores, marca la silla, solicita una sustitución de tela e identifica el piso, la pared, el ángulo de cámara y los objetos cercanos que deben conservarse. Si las marcas solo sirven como guía, pide explícitamente que se eliminen de la imagen terminada.
La guía de edición por coordenadas del fabricante utiliza etiquetas <point> y <bbox> con coordenadas normalizadas de 0 a 999 respecto a la imagen de entrada especificada. Un punto contiene las coordenadas x e y; un cuadro contiene las coordenadas superior izquierda e inferior derecha. Identifica el número de imagen y el objeto que se debe editar, especialmente cuando un cuadro incluye varios sujetos. Para una edición entre imágenes, distingue el objeto que se tomará de una referencia y la zona de destino en otra.
Utiliza las propias dimensiones de la imagen mostrada al obtener la ubicación proporcional; el zoom del lienzo, el desplazamiento o las coordenadas del navegador no son las coordenadas normalizadas de la imagen. Describe las zonas protegidas además de la zona editada. Compara la perspectiva, la iluminación y los detalles circundantes del resultado con la fuente original.
Separa una composición en capas editables
La descomposición en capas es un modo distinto que toma exactamente una imagen y devuelve una imagen base más hasta 16 capas independientes. Cada capa es un PNG con alfa. Un prompt puede nombrar los elementos que deben separarse, como título, sujeto principal y decoraciones; sin un prompt de descomposición, el modelo identifica automáticamente los elementos principales.
Los resultados incluyen nombres de capas, descripciones, orden de apilamiento y cuadros de ubicación. Utiliza la imagen base con índice de apilamiento cero y después coloca las otras capas en orden ascendente de apilamiento. Los cuadros absolutos describen la ubicación en la imagen base de salida; los cuadros normalizados describen la ubicación proporcional en otro lienzo. Conserva estos metadatos de ubicación devueltos con los archivos de imagen para reconstruir la composición original antes de reorganizarla.
Para una revisión de cartel, separa la ilustración principal del título y las decoraciones; después revisa los bordes y cualquier zona restaurada del fondo. Una capa transparente puede editarse como una sola entrada con canal alfa y salida PNG transparente. La opción de fondo transparente se limita a ese flujo de edición con una sola imagen de entrada; la generación habitual de texto a imagen es una operación independiente.
Composición multilingüe
Además de chino e inglés, el fabricante documenta compatibilidad nativa de prompts y texto en imágenes con ruso, árabe, filipino, tailandés, turco, coreano, malayo, español, portugués, indonesio, francés, alemán, vietnamita y japonés. Proporciona el texto aprobado exacto y la dirección de lectura, e identifica qué zona contiene cada bloque de texto. Revisa acentos, caracteres unidos, saltos de línea y etiquetas pequeñas en la imagen final.
Archivos de referencia y especificaciones de salida
La generación de imágenes admite hasta 10 referencias en JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Cada una puede tener hasta 30 MB, con ambos lados superiores a 14 píxeles, entre 196 y 36,000,000 píxeles totales y una relación de aspecto de 1:16 a 16:1. La descomposición en capas requiere en cambio un JPEG o PNG de entre 262,144 y 36,000,000 píxeles, de hasta 30 MB y dentro del mismo rango de proporciones.
La generación ofrece niveles de salida 1K, 1.5K y 2K, con 2K como predeterminado, o dimensiones explícitas con entre 921,600 y 4,624,220 píxeles totales y proporciones de 1:16 a 16:1. Ambas restricciones se aplican a las dimensiones personalizadas. La salida de capas utiliza 1K, 1.5K, 2K o auto, con auto como valor predeterminado; la base y cada capa conservan sus respectivas relaciones de aspecto de origen.
Las imágenes terminadas son JPEG o PNG. El formato de la imagen base puede seleccionarse por separado, mientras que las capas descompuestas siguen siendo PNG con alfa. La entrega puede utilizar datos de imagen codificados o enlaces de descarga conservados durante 24 horas. Guarda cada imagen devuelta y sus metadatos para el flujo de diseño previsto. Revisa texto, detalles editados y alineación de capas al tamaño en que se utilizará el material gráfico.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites bytedance-seed/seedream-5-0-flash | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 Condiciones: Instrucción UTF8 no vacía. No se inventa un límite de caracteres general del fabricante. | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites 1 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminadofalse |
Texto a imagen · Obligatorio: prompt
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetromaterial_types | Contratotext |
Parámetrooptional | Contraton, response_format, stream |
Parámetron | Contrato1 |
Parámetrostream | Contratofalse |
Parámetroresponse_format | Contratourl, b64_json |
Parámetroreference_images | Contratofalse |
Parámetroedit | Contratofalse |
Parámetrooutput_format_optional | Contrato |
Parámetroresolution_control | Contratonull |
Parámetroaspect_ratio_control | Contratonull |
Parámetroother_fields | Contratorechazado salvo el enrutamiento interno exacto y fijado del proveedor |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · El task_id real devuelto o el registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Genera una imagen a partir de una instrucción.
Guarda todos los elementos de data; url/b64_json son codificaciones del resultado.
Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| Configuraciónimagen de entrada | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de entrada | Cargo Entrada · imagen de entrada · Estimación solo para comparar $0 por imagen de entrada |
| ConfiguraciónUltra | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de salida | Cargo Salida · salida de imagen · Estimación solo para comparar $0.036 por imagen de salida |
| ConfiguraciónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Costo estimado de generación · Estimación solo para comparar $0.036 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada. |
Ailoot reserva un monto 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 →
Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónImagen de salida | Condiciones de facturaciónNo se declara ninguna variante de precios. | Cargo Salida · Imagen de salida $0.036 por imagen |
| ConfiguraciónImagen de entrada | Condiciones de facturaciónNo se declara ninguna variante de precios. | Cargo Entrada · Imagen de entrada $0 por imagen |
Los listados equivalentes describen el mismo cargo; no agregan una segunda comisión.
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\n\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\nrequest={'model': 'bytedance-seed/seedream-5-0-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}\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": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};\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 cada elemento de data. Decodifica cada b64_json o descarga el contenido de cada URL firmada devuelta. Elige la extensión del archivo según el MIME y los bytes reales.
Si el resultado de una generación o edición de imágenes requiere una revisión, conserva el operation_id/X-Client-Request-ID original y la información del resultado devuelto. Recupera los resultados existentes de tu propiedad mediante la biblioteca multimedia usando valores reales de task_id o asset_id. No vuelvas a enviar la solicitud de generación o edición ni construyas una URL de consulta de estado 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 revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot Ultra bytedance-seed/seedream-5-0-flash
Usa las rutas de método indicadas arriba.