modelos

OpenAI: GPT Image 2

Markdown · JSON

OpenAI: GPT Image 2

GPT Image 2 genera y edita imágenes a partir de texto y referencias visuales. Admite dimensiones flexibles y procesa automáticamente las imágenes de entrada con alta fidelidad, con controles independientes de calidad, formato y fondo para el recurso terminado.

Sobre el modelo

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.

GPT Image 2 es el modelo de OpenAI para generar y editar imágenes a partir de texto y entradas visuales. Crea una imagen nueva a partir de un encargo escrito y puede utilizar imágenes de origen para ediciones o trabajos guiados por referencias. Las tareas prácticas incluyen ilustraciones, conceptos de producto, composiciones visuales y cambios en un recurso existente. Es una edición independiente de los modelos GPT Image 2.5 Sunburst y Flare, con su propio intervalo de calidad y comportamiento de fidelidad de entrada.

Para generar, describa el sujeto, la escena, la composición, la luz y el estilo previsto. Para editar, indique lo que debe cambiar y lo que debe conservar su aspecto. Un encargo de producto puede pedir una lámpara de cerámica sobre una superficie clara con la silueta centrada y espacio para un pie de imagen; una edición posterior puede cambiar el fondo conservando la forma de la lámpara y el ángulo de visión. Los flujos directos documentados de generación y edición aceptan prompts de hasta 32 000 caracteres y pueden devolver entre una y diez imágenes.

La edición con referencias acepta hasta dieciséis imágenes de entrada. Especifique la finalidad de cada referencia para no confundir el sujeto, el fondo y el tratamiento visual. GPT Image 2 procesa automáticamente todas las imágenes de entrada con alta fidelidad; se debe omitir input_fidelity porque no se puede ajustar en esta edición. Esto difiere de la elección entre high y low en GPT Image 1 y del modo de fidelidad de entrada exclusivamente low de GPT Image 1 Mini. El procesamiento de entrada de alta fidelidad favorece el detalle del original sin garantizar que todos los detalles se reproduzcan sin cambios.

Una máscara puede identificar la zona que se debe editar. La imagen de origen y la máscara deben tener el mismo formato y dimensiones y un tamaño inferior a 50 MB según los requisitos de preparación de la guía; la máscara también necesita un canal alfa. Si se proporcionan varias imágenes de entrada, la máscara se aplica a la primera. El modelo trata la máscara como una orientación basada en el prompt en lugar de un límite geométrico estricto. Describa el cambio local y los requisitos de conservación, y después examine la zona circundante para detectar diferencias no deseadas.

GPT Image 2 admite las calidades low, medium, high y auto, con auto como predeterminada. Los ajustes xhigh y max de la familia 2.5 no forman parte del intervalo de calidad de esta edición. El tamaño puede ser cuadrado, horizontal, vertical, automático o un ancho y alto personalizados válidos. Los ejemplos del proveedor incluyen 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 y 2160 × 3840 píxeles. Elija la orientación y el nivel de detalle según la composición real en vez de tratar la calidad y las dimensiones como un mismo control.

Las dimensiones personalizadas deben ser múltiplos de dieciséis píxeles, con un lado máximo de 3840 píxeles, una relación entre el lado largo y el corto no superior a 3:1 y un área de 655 360 a 8 294 400 píxeles. Deben cumplirse todas estas condiciones simultáneamente. Las resoluciones superiores a 2560 × 1440 se señalan como experimentales. Un formato que satisfaga una regla aún puede incumplir otra, por lo que debe seleccionar una pareja de dimensiones admitida y describir en el encargo los elementos sensibles al recorte.

La salida es PNG de forma predeterminada, con JPEG o WebP también disponibles. Para JPEG y WebP se admite una compresión de 0 a 100. El fondo puede ser opaco o automático; la referencia actual exacta describe la transparencia en GPT Image 2 como una capacidad en vista previa. Al solicitar transparencia, use PNG o WebP para conservar un canal alfa. El flujo de streaming documentado permite hasta tres imágenes parciales antes de la imagen terminada; guarde el recurso final en lugar de una vista previa de progreso. La interfaz del fabricante también admite procesamiento por lotes.

Evalúe la claridad del texto, la posición de los objetos y la conservación de los detalles originales en el resultado real. GPT Image puede tener dificultades con los textos precisos, las composiciones sensibles a la disposición y la identidad visual recurrente entre generaciones independientes. Para una secuencia de ediciones, use el resultado elegido como siguiente origen e indique un cambio concreto vinculado a un problema visible. La salida útil de GPT Image 2 es una imagen asociada a un encargo claro de generación o edición, con sus entradas de alta fidelidad, dimensiones y calidad elegidas para esa tarea específica.

Ailoot · Imágenes POST /v1/images/generations gpt-image-2

gpt-image-2

OpenAI /gpt-image-2

Primeros pasos

GPT Image 2 genera y edita imágenes a partir de texto y referencias visuales. Admite dimensiones flexibles y procesa automáticamente las imágenes de entrada con alta fidelidad, con controles independientes de calidad, formato y fondo para el recurso terminado.

Entradas aceptadas
Texto
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot · Imágenes POST /v1/images/generations
Tipos de entrada
text
Tipos de salida
image
Formato de salida
Archivo de imagen
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
gpt-image-2
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Longitud mínima: 1
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Predeterminado1
Camporesponse_formatTipostringRequisitoOpcionalValores y límites
url, b64_json
Predeterminado—
CampostreamTipobooleanRequisitoOpcionalValores y límitesPredeterminadofalse
CamposizeTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
CampoqualityTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
CampobackgroundTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
Campooutput_formatTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
Campooutput_compressionTipointegerRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
CampomoderationTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
Campoinput_fidelityTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
CampostyleTipostringRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
Campopartial_imagesTipointegerRequisitoOpcionalValores y límites
Depende del modelo
Predeterminado—
Combinaciones de materiales de entrada

Texto a imagen · Obligatorio: prompt

Parámetros del método y ciclo de vida
ParámetroContrato
Parámetromaterial_typesContratotext
ParámetrorequiredContratomodel, prompt
Parámetrooptional_controlsContratonull
Parámetrocontent_typeContratoapplication/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.

Planes

Tarifas de métodos Ailoot

Ailoot ImágenesPOST /v1/images/generations
Entrada de texto
0,0025 US$ / 1K
Entrada, imagen
0,004 US$ / 1K tokens
Salida, imagen
0,015 US$ / 1K tokens

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 →

Solicitudes de ejemplo

Ailoot · Imágenes

curlPython SDKNode.js SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "gpt-image-2", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'gpt-image-2', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "gpt-image-2", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  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";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");

Recibir y guardar resultados

Ailoot · Imágenes

Descarga cada imagen recibida o guarda su contenido Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Conserva todos los resultados completados

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 es necesario revisar la respuesta original

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.

Campos de respuesta
CampoTipo
CampocreatedTipointeger
Campodata[].urlTipostring
Campodata[].b64_jsonTipobase64 string
CampousageTipoobject
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondiciónCampos obligatorios, representación del material o valor del parámetro no válidosSiguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación.
Respuestaserver_errorCondiciónLa respuesta devuelta indica que la operación o el resultado requiere una comprobaciónSiguiente 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.

Alias

Alias del modelo

Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

openai/gpt-image-2, gpt-image-2, gpt-image-2

Ailoot Ultra · Imágenes POST /v1/images/generations gpt-image-2

gpt-image-2

OpenAI /gpt-image-2
ID del modelo
  • gpt-image-2
  • openai/gpt-image-2

Primeros pasos

GPT Image 2 genera y edita imágenes a partir de texto y referencias visuales. Admite dimensiones flexibles y procesa automáticamente las imágenes de entrada con alta fidelidad, con controles independientes de calidad, formato y fondo para el recurso terminado.

Entradas aceptadas
Texto
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations
Tipos de entrada
text
Tipos de salida
image
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
gpt-image-2
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Longitud máxima: 32.000
Predeterminado—
CamposizeTipostringRequisitoOpcionalValores y límites
Condiciones: Usa auto o WIDTHxHEIGHT con ambas dimensiones divisibles por 16. El lado más largo no puede superar los 3,840 píxeles y el tamaño total no puede superar los 8,300,000 píxeles.
Predeterminadoauto
CampobackgroundTipostringRequisitoOpcionalValores y límites
transparent, opaque, auto
Predeterminadoauto
CampomoderationTipostringRequisitoOpcionalValores y límites
low, auto
Condiciones: Usa auto para la moderación estándar del contenido.
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Máximo: 10
Predeterminado1
CampoqualityTipostringRequisitoOpcionalValores y límites
auto, high, medium, low
Predeterminadoauto
Campooutput_compressionTipointegerRequisitoOpcionalValores y límites
Mínimo: 0
Máximo: 100
Condiciones: Se aplica a la salida JPEG y WebP; envía el valor entero documentado.
Predeterminado100
Campooutput_formatTipostringRequisitoOpcionalValores y límites
webp, png, jpeg
Predeterminadopng
CampostreamTipobooleanRequisitoOpcionalValores y límites
false
Condiciones: Esta ruta devuelve una única respuesta JSON completa.
Predeterminadofalse
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratoprompt, model
Parámetromaterial_typesContratotext
ParámetrooptionalContratosize, background, moderation, n, quality, output_compression, output_format, stream
ParámetroconditionsContratoUn fondo transparente requiere PNG o WebP., La compresión de salida se aplica a JPEG o WebP., El método seleccionado genera a partir de texto. Los controles de edición y transmisión continua descritos para el fabricante son capacidades independientes.

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}

Planes

Cómo se calcula el cargo definitivo

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.

Modo rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasCantidad previstaCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—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ónCoste estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónCargo
Salida · Coste estimado de generación · Estimación solo para comparar $0.24576 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 →

Solicitudes de ejemplo

Ailoot Ultra · Imágenes

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · Imágenes

Descarga cada imagen recibida o guarda su contenido Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Otras consultas de contenido
Consultar los archivos existentes que te pertenecen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserva todos los resultados completados

Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.

Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.

Si es necesario revisar la respuesta original

Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.

Campos de respuesta
CampoTipo
CampocreatedTipo
Campodata[].urlTipo
Campodata[].b64_jsonTipo
CampousageTipo

Alias

Alias del modelo

Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

openai/gpt-image-2, gpt-image-2, gpt-image-2

Ailoot Ultra · Imágenes POST /v1/images/generations openai/gpt-image-2

openai/gpt-image-2

OpenAI /openai/gpt-image-2
ID del modelo
  • gpt-image-2
  • openai/gpt-image-2

Primeros pasos

GPT Image 2 genera y edita imágenes a partir de texto y referencias visuales. Admite dimensiones flexibles y procesa automáticamente las imágenes de entrada con alta fidelidad, con controles independientes de calidad, formato y fondo para el recurso terminado.

Entradas aceptadas
Texto · Imágenes
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations
Tipos de entrada
text, image
Tipos de salida
image
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
openai/gpt-image-2
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Longitud mínima: 1
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto
Predeterminado—
CampoqualityTipostringRequisitoOpcionalValores y límites
auto, low, medium, high
Predeterminado—
CampobackgroundTipostringRequisitoOpcionalValores y límites
auto, opaque
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Máximo: 10
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Número mínimo de elementos: 0
Número máximo de elementos: 16
Predeterminado—
Campooutput_compressionTipointegerRequisitoOpcionalValores y límites
Mínimo: 0
Máximo: 100
Predeterminado—
CampoproviderTipoobjectRequisitoOpcionalValores y límitesPredeterminado—
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt
Parámetromaterial_typesContratotext, image

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}

Planes

Cómo se calcula el cargo definitivo

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.

Modo rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasCantidad previstaCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—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ónCoste estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónCargo
Salida · Coste estimado de generación · Estimación solo para comparar $0.24576 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 →

Solicitudes de ejemplo

Ailoot Ultra · Imágenes

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-2', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · Imágenes

Descarga cada imagen recibida o guarda su contenido Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Otras consultas de contenido
Consultar los archivos existentes que te pertenecen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserva todos los resultados completados

Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.

Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.

Si es necesario revisar la respuesta original

Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.

Campos de respuesta
CampoTipo
CampocreatedTipo
Campodata[].urlTipo
Campodata[].b64_jsonTipo
CampousageTipo

Alias

Alias del modelo

Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

openai/gpt-image-2, gpt-image-2, gpt-image-2

FAQ · OpenAI: GPT Image 2
¿Qué entradas y resultados están disponibles?

POST /v1/images/generations · gpt-image-2: text → image

POST /v1/images/generations · gpt-image-2: text → image

POST /v1/images/generations · openai/gpt-image-2: text, image → image

¿Qué campos utiliza la solicitud?

POST /v1/images/generations · gpt-image-2: model, prompt, n, response_format, stream

POST /v1/images/generations · gpt-image-2: model, prompt, size, background, moderation, n, quality, output_compression, output_format, stream

POST /v1/images/generations · openai/gpt-image-2: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider

¿Qué límites se aplican?

POST /v1/images/generations · gpt-image-2: n.minimum: 1

POST /v1/images/generations · gpt-image-2: prompt.maximum_length: 32000; n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

POST /v1/images/generations · openai/gpt-image-2: n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia