Guía de la API de Seedream 5.5: precios, parámetros y ejemplos de llamada

Qué puede hacer Seedream 5.5

Seedream 5.5 es un modelo de imágenes en HiAPI; un único ID de modelo (seedream-5.5) cubre dos usos a la vez: si solo escribes un prompt, es generación de imágenes a partir de texto; si además adjuntas imágenes de referencia, es edición según las imágenes de referencia o conservación del contenido de la escena. Ambos usos pasan por la misma interfaz y el mismo conjunto de parámetros; la única diferencia es si la solicitud incluye image_urls o no.

Cada llamada devuelve una imagen. A continuación se explica en el orden «cómo se calcula el precio → cómo rellenar los parámetros → cómo enviar la solicitud → qué limitaciones hay»; todas las cifras se basan en la definición de la interfaz en el momento de redactar este artículo.

Precio: facturación por tramos de píxeles, con recargo por cada imagen de referencia

El coste se compone de dos partes: el precio base del tramo de salida más el coste de las imágenes de referencia.

• 1K / 1.5K: $0.0186 / imagen
• 2K (tramo predeterminado): $0.0325 / imagen
• Imágenes de referencia: $0.0075 cada una; la primera también se cobra; máximo 10

Algunos ejemplos:

• Generación de imagen a partir de texto en 1K, sin imágenes de referencia: $0.0186
• 2K con 1 imagen de referencia: $0.0325 + $0.0075 = $0.04
• 2K con 10 imágenes de referencia (límite): $0.0325 + $0.075 = $0.1075

Si no se especifica size, se genera en 2K y se factura como 2K. Si solo haces bocetos o imágenes de acompañamiento de pequeño tamaño, indicar explícitamente "size": "1K" permite ahorrar aproximadamente un 40 %. Si la tarea falla, el coste se reembolsa en su totalidad.

Resumen de parámetros

Excepto model y prompt, todos son opcionales:

• prompt: obligatorio, de 1 a 5000 caracteres. Describe la imagen que se va a generar; cuando se incluyen imágenes de referencia, indica claramente qué cambiar y qué conservar.
• size: 1K, 1.5K, 2K; por defecto 2K.
• aspect_ratio: 10 opciones — 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. Si no se especifica, el modelo lo elige automáticamente según el prompt y las imágenes de referencia.
• image_urls: de 1 a 10 direcciones de imagen http(s) de acceso público. Si no se especifica, es generación puramente a partir de texto.
• output_format: png o jpeg; por defecto png.
• background: auto, transparent, opaque; por defecto auto. Al elegir transparent, el formato de salida solo puede ser png; combinarlo con jpeg será rechazado.

Enviar una solicitud

Las tareas de imagen de HiAPI son asíncronas: primero se crea la tarea y luego se consulta el resultado. model va en el nivel superior y el resto de parámetros dentro de input.

Generación de imagen a partir de texto (2K, 16:9):

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "Faro junto al mar al amanecer, niebla ligera, luz lateral suave, estilo fotografía realista",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

Edición con imagen de referencia (1K, fondo transparente, PNG):

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "Conserva el cuerpo de la botella y la etiqueta, elimina el fondo y cámbialo por una luz cenital suave",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

El coste de este pedido es $0.0186 + $0.0075 = $0.0261. Tras crearlo correctamente, usa el ID de tarea devuelto para consultar periódicamente con GET https://api.hiapi.ai/v1/tasks/{taskId}; cuando el estado cambie a éxito, obtén la dirección de la imagen de la salida y descárgala.

Limitaciones actuales

• Máximo 2K; no hay tramo de 4K.
• No admite salida de imágenes por capas.
• Cada llamada genera solo una imagen; si necesitas varias, envía varias tareas en paralelo.
• Las imágenes de referencia deben ser direcciones http(s) accesibles desde la red pública; no se aceptan rutas de archivos locales ni base64.
• El fondo transparente solo admite PNG.

Cómo elegir el tramo

Para carteles que se publicarán directamente o imágenes principales de productos, usa el 2K predeterminado; para borradores de revisión interna, pruebas de estilo por lotes o miniaturas de pequeño tamaño, usa 1K o 1.5K (ambos cuestan lo mismo; 1.5K es más nítido, así que si no hay motivo para elegir 1K, usa directamente 1.5K). Las imágenes de referencia se cobran por unidad; incluye solo las que realmente influyan en el resultado; para varias vistas del mismo producto, prueba primero con 1 o 2 y añade más si el efecto no es suficiente.