Una edición de creación de imágenes más rápida
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 la 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 prioridad de Pro por una mayor calidad de imagen, sin establecer un tiempo fijo de respuesta para todos los encargos.
Las funciones compartidas distintivas son la edición interactiva, la descomposición en capas y la 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 del prompt 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 encargo y referencias
Indica la imagen prevista, el sujeto principal, la composición y el tratamiento visual y 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 un material superficial. «Conserva la silueta y el ángulo de visión del objeto de la primera imagen; utiliza la segunda solo para la paleta apagada del fondo» da funciones distintas a las referencias.
El fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras inglesas. Es una orientación de preparación, no un límite estricto declarado de entrada textual. Enumera primero los requisitos decisivos, incluido el texto exacto que deba aparecer, la relación de aspecto deseada y los detalles que deban permanecer sin cambios. Inspecciona la imagen terminada frente a esa lista en lugar de confiar solo en su aspecto general.
Edición guiada espacialmente
Flash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe realizarse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interior, marca la silla, solicita una sustitución del tejido e identifica el suelo, la pared, el ángulo de cámara y los objetos próximos que deben conservarse. Si las marcas solo sirven de 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 a 0–999 respecto a la imagen de entrada especificada. Un punto contiene x e y; un cuadro contiene las coordenadas superior izquierda e inferior derecha. Identifica el número de imagen y el objeto objetivo, especialmente cuando un cuadro incluya varios sujetos. Para editar entre imágenes, distingue el objeto que tomar de una referencia y la zona de destino en otra.
Utiliza las dimensiones de la propia 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 imagen. Describe las zonas protegidas además de la zona editada. Compara la perspectiva, la iluminación y el detalle circundante del resultado con la fuente original.
Separar una composición en capas editables
La descomposición en capas es un modo distinto que recibe 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 separar, como el título, el sujeto principal y las 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 colocación. Utiliza la imagen base con índice de apilamiento cero y después coloca las demás capas en orden de apilamiento ascendente. Los cuadros absolutos describen la colocación en la imagen base de salida; los normalizados describen la colocación proporcional en otro lienzo. Conserva esos metadatos de colocación devueltos junto con los archivos de imagen para poder reconstruir la composición original antes de reorganizarla.
Para revisar un cartel, separa la ilustración principal del título y las decoraciones e inspecciona después los bordes y cualquier zona de fondo reconstruida. Una capa transparente puede editarse como una única entrada con canal alfa y salida PNG transparente. La opción de fondo transparente se limita a ese flujo de edición de imagen con una sola entrada; la generación habitual de texto a imagen es una operación separada.
Composición multilingüe
Además de chino e inglés, el fabricante documenta compatibilidad nativa de prompts y texto de imagen en ruso, árabe, filipino, tailandés, turco, coreano, malayo, español, portugués, indonesio, francés, alemán, vietnamita y japonés. Proporciona la redacción exacta aprobada y la dirección de lectura e identifica qué zona contiene cada bloque de texto. Revisa los acentos, los caracteres ligados, los saltos de línea y las etiquetas pequeñas en la imagen final.
Archivos de referencia y especificaciones de salida
La generación de imágenes acepta 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 262 144–36 000 000 píxeles, hasta 30 MB y dentro del mismo intervalo de relaciones.
La generación ofrece niveles de salida 1K, 1.5K y 2K, con 2K como predeterminado, o dimensiones explícitas con 921 600–4 624 220 píxeles totales y relaciones 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 predeterminado; la base y cada capa conservan las relaciones de aspecto de sus respectivas fuentes.
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 todas las imágenes devueltas y sus metadatos para el flujo de diseño previsto. Inspecciona el texto, los detalles editados y la alineación de las capas al tamaño al que se utilizará el material visual.
", "aboutText": "Una edición de creación de imágenes más rápida\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 la 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 prioridad de Pro por una mayor calidad de imagen, sin establecer un tiempo fijo de respuesta para todos los encargos.\n\nLas funciones compartidas distintivas son la edición interactiva, la descomposición en capas y la 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 del prompt 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 encargo y referencias\n\nIndica la imagen prevista, el sujeto principal, la composición y el tratamiento visual y 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 un material superficial. «Conserva la silueta y el ángulo de visión del objeto de la primera imagen; utiliza la segunda solo para la paleta apagada del fondo» da funciones distintas a las referencias.\n\nEl fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras inglesas. Es una orientación de preparación, no un límite estricto declarado de entrada textual. Enumera primero los requisitos decisivos, incluido el texto exacto que deba aparecer, la relación de aspecto deseada y los detalles que deban permanecer sin cambios. Inspecciona la imagen terminada frente a esa lista en lugar de confiar solo en su aspecto general.\n\nEdición guiada espacialmente\n\nFlash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe realizarse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interior, marca la silla, solicita una sustitución del tejido e identifica el suelo, la pared, el ángulo de cámara y los objetos próximos que deben conservarse. Si las marcas solo sirven de 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-flashCrear 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 de creación de imágenes más rápida
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 la 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 prioridad de Pro por una mayor calidad de imagen, sin establecer un tiempo fijo de respuesta para todos los encargos.
Las funciones compartidas distintivas son la edición interactiva, la descomposición en capas y la 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 del prompt 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 encargo y referencias
Indica la imagen prevista, el sujeto principal, la composición y el tratamiento visual y 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 un material superficial. «Conserva la silueta y el ángulo de visión del objeto de la primera imagen; utiliza la segunda solo para la paleta apagada del fondo» da funciones distintas a las referencias.
El fabricante recomienda prompts concisos, de no más de 300 caracteres chinos o 600 palabras inglesas. Es una orientación de preparación, no un límite estricto declarado de entrada textual. Enumera primero los requisitos decisivos, incluido el texto exacto que deba aparecer, la relación de aspecto deseada y los detalles que deban permanecer sin cambios. Inspecciona la imagen terminada frente a esa lista en lugar de confiar solo en su aspecto general.
Edición guiada espacialmente
Flash puede utilizar puntos, cuadros delimitadores, flechas y marcas de forma libre para identificar dónde debe realizarse una edición. Proporciona la imagen de origen junto con una ubicación y el cambio. Para un concepto de interior, marca la silla, solicita una sustitución del tejido e identifica el suelo, la pared, el ángulo de cámara y los objetos próximos que deben conservarse. Si las marcas solo sirven de 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 a 0–999 respecto a la imagen de entrada especificada. Un punto contiene x e y; un cuadro contiene las coordenadas superior izquierda e inferior derecha. Identifica el número de imagen y el objeto objetivo, especialmente cuando un cuadro incluya varios sujetos. Para editar entre imágenes, distingue el objeto que tomar de una referencia y la zona de destino en otra.
Utiliza las dimensiones de la propia 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 imagen. Describe las zonas protegidas además de la zona editada. Compara la perspectiva, la iluminación y el detalle circundante del resultado con la fuente original.
Separar una composición en capas editables
La descomposición en capas es un modo distinto que recibe 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 separar, como el título, el sujeto principal y las 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 colocación. Utiliza la imagen base con índice de apilamiento cero y después coloca las demás capas en orden de apilamiento ascendente. Los cuadros absolutos describen la colocación en la imagen base de salida; los normalizados describen la colocación proporcional en otro lienzo. Conserva esos metadatos de colocación devueltos junto con los archivos de imagen para poder reconstruir la composición original antes de reorganizarla.
Para revisar un cartel, separa la ilustración principal del título y las decoraciones e inspecciona después los bordes y cualquier zona de fondo reconstruida. Una capa transparente puede editarse como una única entrada con canal alfa y salida PNG transparente. La opción de fondo transparente se limita a ese flujo de edición de imagen con una sola entrada; la generación habitual de texto a imagen es una operación separada.
Composición multilingüe
Además de chino e inglés, el fabricante documenta compatibilidad nativa de prompts y texto de imagen en ruso, árabe, filipino, tailandés, turco, coreano, malayo, español, portugués, indonesio, francés, alemán, vietnamita y japonés. Proporciona la redacción exacta aprobada y la dirección de lectura e identifica qué zona contiene cada bloque de texto. Revisa los acentos, los caracteres ligados, los saltos de línea y las etiquetas pequeñas en la imagen final.
Archivos de referencia y especificaciones de salida
La generación de imágenes acepta 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 262 144–36 000 000 píxeles, hasta 30 MB y dentro del mismo intervalo de relaciones.
La generación ofrece niveles de salida 1K, 1.5K y 2K, con 2K como predeterminado, o dimensiones explícitas con 921 600–4 624 220 píxeles totales y relaciones 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 predeterminado; la base y cada capa conservan las relaciones de aspecto de sus respectivas fuentes.
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 todas las imágenes devueltas y sus metadatos para el flujo de diseño previsto. Inspecciona el texto, los detalles editados y la alineación de las capas al tamaño al que se utilizará el material visual.
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 de texto UTF8 no vacía. No se inventa ningún 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 para el enrutamiento interno exacto y fijado del proveedor |
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}
Genera una imagen a partir de una instrucción de texto.
Guarda todos los elementos de data; url/b64_json son codificaciones del resultado.
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen 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ónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Coste 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 para la generación completada. |
Ailoot 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 →
Las tablas de referencia del modelo no cambian la selección del método, las estimaciones de coste 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 precio. | Cargo Salida · Imagen de salida $0.036 por imagen |
| ConfiguraciónImagen de entrada | Condiciones de facturaciónNo se declara ninguna variante de precio. | Cargo Entrada · Imagen de entrada $0 por imagen |
Los listados equivalentes describen el mismo cargo; no añaden 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 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 Ultra bytedance-seed/seedream-5-0-flash
Usa las rutas de método indicadas arriba.