Felo API PlatformFelo API Platform
Volver a los modelos

Hy Image 3.5 Preview API

Modelo de generación y edición de imágenes de Tencent, en versión preview, pensado para creación visual profesional con entradas de texto e imagen y salidas de hasta 4K.

Hy Image 3.5 Preview es un modelo de imagen de Tencent presentado el 22 de septiembre de 2026. Acepta texto e imágenes como entrada y genera imágenes como salida, por lo que cubre tanto la generación a partir de texto como la edición guiada por imagen. Admite hasta 5 imágenes de referencia por solicitud, relaciones de aspecto múltiples y resoluciones de salida de 1K, 2K y 4K. Además, permite flujos conversacionales de varios turnos para crear y editar a partir del contexto previo.

El modelo está orientado a la creación de imágenes profesional con una buena relación entre capacidad y coste, más que a liderar clasificaciones de benchmarks. Destaca en comprensión semántica del chino y en un estilo realista adecuado para entregas comerciales. Su renderizado fotográfico cuida la textura de la piel, el tejido de las telas y la iluminación de contorno. También ofrece renderizado multilingüe de texto y tipografía, lo que resulta útil para carteles, infografías y materiales de marca.

Es adecuado para tareas como visuales publicitarios, infografías, diseño de interfaces, retoque fotográfico, embellecimiento de retratos, tarjetas de conocimiento, carteles comerciales, storyboards de episodios, materiales de cine y televisión, ilustración creativa, identidad de marca y materiales de comercio electrónico. Al tratarse de una versión preview, su comportamiento, límites y precio pueden cambiar; en producción conviene fijar manualmente el tamaño, ya que la selección automática puede variar la orientación entre ejecuciones.

Actualizado:

ID DEL MODELO

hy-image-v3.5-preview
Entrada
text / image
Salida
image

Aspectos destacados

  • Generación texto-imagen y edición imagen-imagen
  • Hasta 5 imágenes de referencia por solicitud
  • Salidas en 1K, 2K y 4K
  • Creación y edición conversacional multiturno
  • Renderizado multilingüe de texto y tipografía
  • Estilo realista para entregas comerciales

Proveedores

1 proveedores

Compara los precios de API entre proveedores. Selecciona un proveedor para ver todos los cargos y condiciones.

Proveedor · Detalles de precio
Disponibilidad

Inicio rápido

Envía una tarea de imagen, consulta su estado y guarda las imágenes. Los ejemplos usan curl y la biblioteca estándar de Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Configura tu clave de API

Crea una clave en tu cuenta de Felo API Platform y configúrala como variable de entorno.

export FELO_API_KEY="YOUR_API_KEY"

2Haz tu primera solicitud

Los valores opcionales dependen del modelo y se omiten en el ejemplo. Confírmalos en Playground. Los campos van al mismo nivel que model y prompt, sin envoltorio input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "hy-image-v3.5-preview"
}'

3Consultar tarea

La respuesta incluye task_id. Consulta cada 3 segundos mientras esté queued o running; termina con succeeded, failed o interrupted. Espera máxima: 30 minutos. Conserva created.json para continuar sin volver a enviar la tarea.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Descargar salida

Tras el éxito, guarda outputs de task.json. Admite URL HTTPS, objetos URL y b64_json. Descarga pronto las URL firmadas; no necesitas la clave API para descargar imágenes.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Para editar imágenes, sustituye la URL de ejemplo por tu URL HTTPS o una data URL de imagen en base64. Envía una vez y sigue los mismos pasos de consulta y guardado.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "hy-image-v3.5-preview",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Parámetros compatibles

  • n
  • seed
  • size
  • resolution
  • aspect_ratio
  • input_references

¿Prefieres la referencia completa?

Referencia de la API →

Preguntas frecuentes

¿Qué es Hy Image 3.5 Preview?

Hy Image 3.5 Preview es un modelo de imagen de Tencent presentado el 22 de septiembre de 2026. Acepta texto e imágenes como entrada y genera imágenes como salida, por lo que cubre tanto la generación a partir de texto como la edición guiada por imagen. Admite hasta 5 imágenes de referencia por solicitud, relaciones de aspecto múltiples y resoluciones de salida de 1K, 2K y 4K. Además, permite flujos conversacionales de varios turnos para crear y editar a partir del contexto previo. El modelo está orientado a la creación de imágenes profesional con una buena relación entre capacidad y coste, más que a liderar clasificaciones de benchmarks. Destaca en comprensión semántica del chino y en un estilo realista adecuado para entregas comerciales. Su renderizado fotográfico cuida la textura de la piel, el tejido de las telas y la iluminación de contorno. También ofrece renderizado multilingüe de texto y tipografía, lo que resulta útil para carteles, infografías y materiales de marca. Es adecuado para tareas como visuales publicitarios, infografías, diseño de interfaces, retoque fotográfico, embellecimiento de retratos, tarjetas de conocimiento, carteles comerciales, storyboards de episodios, materiales de cine y televisión, ilustración creativa, identidad de marca y materiales de comercio electrónico. Al tratarse de una versión preview, su comportamiento, límites y precio pueden cambiar; en producción conviene fijar manualmente el tamaño, ya que la selección automática puede variar la orientación entre ejecuciones.

¿Cómo se cobra el uso?

Tu factura depende del proveedor que uses, de sus precios y de tu uso. Las entradas más largas u otras condiciones pueden tener precios distintos.

¿Qué tipos de entrada admite Hy Image 3.5 Preview?

Acepta texto e imágenes como entrada, y genera imágenes como salida. Esto cubre la generación a partir de texto y la edición a partir de imágenes de referencia.

¿Cuántas imágenes de referencia puede usar por solicitud?

Admite hasta 5 imágenes de referencia en cada solicitud. Esto facilita mantener la consistencia en la edición con referencias.

¿Qué resoluciones y relaciones de aspecto puede generar?

Ofrece resoluciones de salida de 1K, 2K y 4K, y admite varias relaciones de aspecto. La selección automática de tamaño puede variar la orientación entre ejecuciones, por lo que se recomienda fijar el tamaño manualmente en producción.

¿Para qué tareas está pensado?

Está orientado a creación de imágenes profesional: visuales publicitarios, infografías, diseño de interfaces, retoque fotográfico, carteles comerciales, storyboards y materiales de comercio electrónico, entre otros.

¿En qué se diferencia de otras versiones de la familia?

Tencent lo sitúa como un modelo con buena relación capacidad-coste para creación profesional, con una mejora global de alrededor del 30% respecto a la generación anterior según sus pruebas internas. No está planteado como líder de puntuaciones en benchmarks.

¿Cómo se integra en herramientas y API?

Está disponible en Tencent Yuanbao e ima, integrado en el banco de trabajo Tencent Cloud ADP y ofrecido mediante nodos asociados en ComfyUI para generación a partir de texto y edición de imágenes. La API usa el protocolo Chat/Messages con entrada de varias imágenes, contexto de edición multiturno y reescritura con cadena de pensamiento, bajo el identificador de modelo hy-image-v3.5-preview.

Modelos relacionados