

Cómo generar imágenes con Seedream 5.0 Pro
Guía paso a paso para llamar a Seedream 5.0 Pro en APIMart: autenticación, campos de la solicitud, consulta de tareas, lectura de resultados y guardado de imágenes antes de que caduquen los enlaces.
Puedes poner en marcha Seedream 5.0 Pro con una solicitud POST, una API key y un paso más: envías el trabajo, recibes un task_id y consultas la tarea hasta que la imagen esté lista. Seedream 5.0 Pro es asíncrono, así que la primera respuesta nunca trae la imagen.
La versión corta:
- Envío las solicitudes a
https://api.apimart.ai/v1/images/generations - Añado
Authorization: Bearer YOUR_API_KEY - Pongo
modelenseedream-5-0-pro - Incluyo
prompt, además deresolution(1K,1.5Ko2K) ysize(autoo una relación de aspecto como16:9) - Para editar o combinar imágenes, añado hasta 10 imágenes de referencia en
image_urls - Consulto
GET /v1/tasks/{task_id}cada 5–10 segundos hasta que el estado seacompleted - Descargo el resultado enseguida, porque los enlaces de imagen son válidos durante 72 horas
Lo más importante: es un modelo de una sola imagen. Cada solicitud devuelve una imagen y un n mayor que 1 se rechaza. Puedes probar la Seedream 5.0 Pro API en APIMart; la lista completa de campos está en la referencia de la API.

Puntos clave
- Seedream 5.0 Pro se llama con una solicitud POST a
https://api.apimart.ai/v1/images/generations, la cabecera Authorization: Bearer YOUR_API_KEY y model igual a seedream-5-0-pro. - El nivel de salida se elige con resolution (1K, 1.5K o 2K) y la forma con size: auto, una de diez relaciones de aspecto o píxeles exactos. 1.5K cuesta lo mismo que 1K; 3K y 4K devuelven 400.
- Cada solicitud genera una imagen. n mayor que 1, la generación en grupo, el streaming y la búsqueda web se rechazan con 400 y no se crea ninguna tarea.
- La edición de imágenes envía hasta 10 imágenes de referencia en image_urls, como URL públicas o Data URI en Base64.
- La primera respuesta solo contiene un task_id. Consulta el endpoint de tareas cada 5–10 segundos y guarda la imagen antes de 72 horas.
Comparación rápida
| Elemento | Para qué lo uso | Límite o nota clave |
|---|---|---|
| Texto a imagen | Imágenes nuevas solo con el prompt | No necesita imagen de entrada |
| Edición con una referencia | Cambiar el fondo, la luz o detalles de una imagen | Un elemento en image_urls |
| Edición con varias referencias | Combinar personas, ropa o escenas | Hasta 10 imágenes de referencia |
| Descomposición en capas | Dividir un póster en capas editables | Exactamente una imagen de entrada, hasta 16 capas PNG |
| Fondo transparente | Editar una capa conservando el alfa | Una imagen de entrada con alfa, output_format: "png" |
En resumen: esta guía muestra cómo configuro la autenticación, construyo el cuerpo de la solicitud, consulto la tarea y guardo el resultado sin perder archivos.
1. Configura el acceso a la API y la autenticación
1.1 Crea tu cuenta de APIMart y genera una API key

Regístrate en APIMart, abre la página de gestión de API keys en tu panel y crea una clave. Cópiala en el momento y guárdala en el servidor, en un gestor de secretos o en una variable de entorno.
Nunca pongas la clave en código de frontend ni en un repositorio público: quien la tenga podrá gastar tu saldo. En Node.js, léela desde process.env.APIMART_API_KEY; en una terminal, usa export APIMART_API_KEY="your-key-here".
1.2 Define la URL base y la cabecera de autenticación Bearer
Todas las solicitudes van a la URL base https://api.apimart.ai y llevan dos cabeceras:
| Cabecera | Valor |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
Mantén el prefijo Bearer con exactamente un espacio. Un token ausente o mal formado devuelve 401. Si cURL funciona pero tu app no, el fallo suele estar en cómo la app construye las cabeceras.
2. Construye una solicitud de imagen de Seedream 5.0 Pro

2.1 Campos principales: Model, Prompt, Resolution y Size
Una solicitud de texto a imagen necesita model y prompt. Otros dos campos controlan la salida:
model:seedream-5-0-pro(también se aceptaseedream-5.0-pro).prompt: una descripción en lenguaje natural. Además de chino e inglés, el modelo renderiza texto de forma nativa en español, japonés, coreano, portugués, francés, alemán, ruso, indonesio, vietnamita y otros idiomas. Mantenlo en unas 600 palabras en inglés; los prompts muy largos pueden perder detalle.resolution:1K(por defecto),1.5Ko2K. 1.5K cuesta lo mismo que 1K, así que suele ser la mejor opción.size:auto(por defecto), una de diez relaciones de aspecto (1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9) o píxeles exactos como2048x1024. Los píxeles exactos deben sumar entre 921.600 y 4.624.220, con una relación de aspecto entre 1:16 y 16:1.
Por ejemplo, resolution: "1.5K" con size: "16:9" devuelve una imagen de 2048×1152.
2.2 Campos opcionales
| Parámetro opcional | Tipo | Cuándo usarlo |
|---|---|---|
image_urls | Array | Edición y composición con varias referencias; hasta 10 URL públicas o Data URI en Base64 |
output_format | String | jpeg (por defecto) o png |
background | String | transparent para conservar el alfa al editar una imagen que ya tiene canal alfa (requiere png) |
layer_decomposition | Boolean | Dividir una imagen en una base y hasta 16 capas PNG transparentes |
optimize_prompt_options | Object | Optimización del prompt; solo se admite {"mode": "standard"} |
watermark | Boolean | Añadir una marca “generado por IA” abajo a la derecha |
nsfw_check | Boolean | Moderar el prompt y las imágenes de entrada antes de enviar la tarea |
Cada imagen de referencia puede ser jpeg, png, webp, bmp, tiff, gif, heic o heif, de hasta 30 MB y 36 millones de píxeles. La primera referencia es gratuita; cada una adicional suma un recargo fijo.
Para situar una edición con precisión, escribe coordenadas en el prompt: <point>x y</point> para un punto o <bbox>x1 y1 x2 y2</bbox> para un área.
2.3 Campos que este modelo rechaza
Seedream 5.0 Pro es un modelo de una sola imagen. Estas solicitudes devuelven 400, no crean tarea y no se cobran:
nmayor que 1, osequential_image_generation(usa Seedream 5.0 Lite para imágenes en grupo)streamotools(no admite streaming ni búsqueda web)- más de 10 elementos en
image_urls - niveles no admitidos como
3Ko4K, o relaciones de aspecto fuera de la lista anterior
2.4 Ejemplos de llamadas en cURL y JavaScript
Esta es una solicitud cURL mínima para una imagen 16:9 en el nivel 1.5K:
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header "Authorization: Bearer $APIMART_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedream-5-0-pro",
"prompt": "A sunlit mountain trail in autumn, photorealistic, wide angle",
"resolution": "1.5K",
"size": "16:9"
}'
La respuesta solo confirma la tarea:
{
"code": 200,
"data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}
Y esta es una edición con varias referencias en Node.js con fetch:
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APIMART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-5-0-pro",
prompt: "Replace the outfit in image 1 with the outfit in image 2",
image_urls: ["https://example.com/person.jpg", "https://example.com/dress.jpg"],
resolution: "2K",
size: "auto",
}),
});
const { data } = await response.json();
const taskId = data[0].task_id;
Haz estas llamadas desde tu servidor, nunca desde el código del cliente.
3. Consulta la tarea y guarda la imagen
3.1 Comprueba el estado de la tarea
Envía GET https://api.apimart.ai/v1/tasks/{task_id} con la misma cabecera Authorization. Seedream 5.0 Pro prioriza la calidad, así que una tarea puede tardar unos minutos. Consulta cada 5–10 segundos y fija el timeout del cliente en unos 5 minutos.
Deja de consultar cuando status sea completed o failed. Las tareas fallidas se reembolsan por completo.
3.2 Lee el resultado
Una tarea terminada tiene este aspecto:
{
"code": 200,
"data": {
"id": "task_01JFXYZ123456789ABCDEF",
"status": "completed",
"progress": 100,
"result": {
"images": [
{
"url": ["https://cdn.example.com/images/image_task_xxx_0.png"],
"expires_at": 1784696685
}
]
}
}
}
Lee la imagen en data.result.images[0].url[0]. La respuesta también incluye el cost de la tarea. Los enlaces son válidos 72 horas (expires_at es una marca de tiempo Unix), así que descarga el archivo y muévelo a tu propio almacenamiento en lugar de guardar la URL.
3.3 Ejemplo completo en Python
import os
import time
import requests
BASE_URL = "https://api.apimart.ai"
headers = {
"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}",
"Content-Type": "application/json",
}
created = requests.post(
f"{BASE_URL}/v1/images/generations",
headers=headers,
json={
"model": "seedream-5-0-pro",
"prompt": "A product poster with the headline SUMMER SALE in bold letters",
"resolution": "1.5K",
"size": "3:4",
"output_format": "png",
},
timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"][0]["task_id"]
while True:
task = requests.get(f"{BASE_URL}/v1/tasks/{task_id}", headers=headers, timeout=30).json()["data"]
if task["status"] == "completed":
image_url = task["result"]["images"][0]["url"][0]
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", task["status"]))
time.sleep(5)
with open("seedream-5-0-pro.png", "wb") as f:
f.write(requests.get(image_url, timeout=60).content)
4. Tres flujos de imagen habituales
-
Pósteres y gráficos con texto. Escribe entre comillas el texto exacto dentro del prompt, describe la composición (por ejemplo, “póster vertical, titular arriba”) y usa
resolution: "1.5K"con una relación fija como3:4. Pasa a2Ksolo para los recursos finales, ya que ese nivel cuesta más. -
Edición con varias referencias. Pon las imágenes de persona, producto o escena en
image_urlsy nómbralas por orden en el prompt (“imagen 1”, “imagen 2”). Consize: "auto", la proporción de salida sigue a las referencias. Puedes añadir coordenadas<bbox>para indicar exactamente dónde va cada cosa. -
Descomposición en capas y ediciones con transparencia. Envía un PNG o JPEG con
layer_decomposition: truepara obtener una imagen base y hasta 16 capas PNG transparentes con datos de posición y orden. Para editar una capa, envíala de nuevo conbackground: "transparent"youtput_format: "png". Las tareas de capas se cobran por imagen de salida tras una preautorización, y lo que sobre se reembolsa.
5. Lista final para una integración fiable de Seedream 5.0 Pro
Autenticación y seguridad de la clave. Guarda la clave en una variable de entorno o un gestor de secretos y llama a la API solo desde tu backend.
Valida los parámetros antes de enviarlos. Usa seedream-5-0-pro, omite n (o ponlo en 1), mantén image_urls en 10 o menos y usa solo 1K, 1.5K o 2K con un size admitido.
Diseña para el flujo asíncrono. Consulta cada 5–10 segundos, fija un timeout de cliente de unos 5 minutos y gestiona las tareas failed.
Trata la entrega como un problema de almacenamiento. Descarga cada imagen en cuanto la tarea tenga éxito; los enlaces caducan a las 72 horas.
Revisa el coste antes de escalar. La salida se cobra por imagen según el nivel de píxeles (1K y 1.5K comparten el precio más bajo; 2K cuesta más) y cada referencia después de la primera suma un recargo. Consulta la tabla de precios actualizada antes de lanzar lotes grandes.
Preguntas frecuentes
¿Cómo compruebo una tarea de imagen después de recibir un task_id?
Envía GET https://api.apimart.ai/v1/tasks/{task_id} con tu cabecera Authorization: Bearer.
Consulta cada 5–10 segundos hasta que status sea completed y lee la imagen en data.result.images[0].url[0]. Si el estado es failed, revisa el campo error; las tareas fallidas se reembolsan.
¿Puedo obtener varias imágenes o una salida en Base64 en una sola solicitud?
No. Seedream 5.0 Pro devuelve una imagen por solicitud y un n mayor que 1 se rechaza con 400. Para varias variantes, envía varias solicitudes o usa Seedream 5.0 Lite para generación en grupo.
El resultado siempre es una URL; elige jpeg o png con output_format. Base64 se admite para imágenes de entrada en image_urls, no para la salida.
¿Cuál es la mejor forma de no perder las imágenes generadas?
Los enlaces de imagen son válidos durante 72 horas, y expires_at en el resultado indica el momento exacto.
Descarga cada imagen a tu propio almacenamiento en cuanto la tarea llegue a completed y guarda tú mismo el task_id. No trates la URL devuelta como almacenamiento permanente.
Sobre el equipo de APIMart
El equipo de APIMart escribe guías de modelos, comparativas y análisis de precios para desarrolladores que construyen con IA. APIMart ofrece una sola API para modelos de chat, imagen y vídeo de varios proveedores, así que puedes comparar los modelos de este artículo antes de lanzar.
Elige el modelo que quieres en el marketplace
Prueba modelos de chat, imagen y video en el marketplace de APIMart y experimenta rápidamente sus capacidades con una API unificada.
