Calidad de imagen insignia
Seedream 5 Pro renderiza escenas fotorrealistas, packshots editoriales y texto preciso en imagen a 1K o 2K — al nivel de GPT Image y NanoBanana.
Guía API Seedream 5 Pro
Seedream 5 Pro es el modelo de imagen insignia de ByteDance — gran renderizado de texto multilingüe, edición multi-referencia y salida fotorrealista limpia. En Seedance API lo llamas como un alias estable con endpoints REST simples, polling asíncrono y precio por imagen.
Salida 1K o 2K
1:1 a 16:9, 9:16, 2:3, 3:2
Prompt o hasta 10 imágenes de referencia
JSON sobre HTTPS
Petición inicial
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations devuelve un task_id. Poll GET /v1/images/generations/:task_id hasta que status sea SUCCESS y lee images[].url.
Los equipos eligen la API Seedream 5 Pro cuando necesitan calidad de imagen insignia detrás de una superficie REST predecible — sin SDK de proveedor ni cambios de esquema sorpresa.
Seedream 5 Pro renderiza escenas fotorrealistas, packshots editoriales y texto preciso en imagen a 1K o 2K — al nivel de GPT Image y NanoBanana.
Llamas a model "seedream-5-pro". El enrutado, la capacidad y los fallbacks quedan de nuestro lado — tu integración no sufre cambios upstream.
9 créditos por imagen 1K, 18 por 2K, más 0,8 por imagen de referencia extra desde la segunda. estimated_credits vuelve en cada respuesta de creación.
La superficie pública expone lo que el modelo realmente hace: texto-a-imagen y edición guiada por referencias con hasta diez imágenes.
Envía un prompt de hasta 3000 caracteres con relación de aspecto y resolución — el modelo se encarga de composición, luz y tipografía en imagen.
Pasa 1–10 URLs HTTPS públicas en image_urls para editar, componer o reestilizar visuales existentes — cambio de producto, fondo, transferencia de estilo.
Pon resolution en "2k" para renders con calidad de impresión y assets finales. 1K cubre previews e iteraciones.
Una de sus mayores fortalezas — texto legible en inglés, chino, japonés y más dentro de pósters y rótulos.
La creación devuelve task_id al instante. Poll el estado a tu ritmo y mantén la UI receptiva — sin conexiones largas.
El formato de respuesta se mantiene estable sea cual sea el enrutado upstream — consumed_credits, status y URLs de imagen están normalizados.
Tres pasos desde la clave API hasta la URL de imagen final.
Inicia sesión, abre la página API Keys y copia una clave para uso en servidor. Mantenla en tu backend — nunca en código de navegador.
Llama a POST /v1/images/generations con model "seedream-5-pro", tu prompt, aspect_ratio, resolution y image_urls opcional. Recibes task_id y estimated_credits.
Llama a GET /v1/images/generations/:task_id. Cuando status llegue a SUCCESS, lee images[0].url y muestra o archiva el resultado.
Dos endpoints cubren todo el ciclo — crear y hacer polling.
Crea una tarea Seedream 5 Pro. image_urls vacío = texto-a-imagen; 1–10 URLs = edición por referencia. Respuesta 202 con task_id y estimated_credits.
Devuelve IN_PROGRESS, SUCCESS con images[].url o FAILED con objeto de error. También informa consumed_credits al terminar.
400 parámetros inválidos, 401 clave inválida, 402 créditos insuficientes, 404 tarea no encontrada, 429 rate limit, 503 upstream no disponible. Tabla completa en la doc.
| Parámetro | Valor |
|---|---|
| model | Debe ser "seedream-5-pro" — el único modelo público en esta ruta. |
| prompt | Prompt de texto o instrucción de edición, 1–3000 caracteres. |
| aspect_ratio | Uno de 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. Por defecto 1:1. |
| resolution | "1k" (por defecto, 9 créditos) o "2k" (18 créditos). |
| image_urls | 0–10 URLs HTTPS públicas. Array vacío = puro texto-a-imagen. |
Los parámetros desconocidos se rechazan con 400 UNKNOWN_PARAMETER — el contrato permanece explícito. Esquema completo en /docs/images.
Precio fijo por imagen en créditos de Seedance API. La respuesta de creación incluye estimated_credits; el estado final informa consumed_credits.
| Modo | Créditos | Notas |
|---|---|---|
| Texto-a-imagen · 1K | 9 créditos / imagen | Resolución por defecto — para iteraciones y previews. |
| Texto-a-imagen · 2K | 18 créditos / imagen | Calidad de impresión para assets finales. |
| Edición por referencia | +0,8 créditos / imagen extra | Primera referencia incluida; las imágenes 2–10 suman 0,8 cada una. |
Respuestas para desarrolladores que evalúan la API Seedream 5 Pro en Seedance API.
Seedance API expone Seedream 5 Pro tras una superficie REST estable — toda la capacidad del modelo con auth, facturación y respuestas normalizadas, sin gestionar credenciales del proveedor.
Array image_urls vacío para texto-a-imagen. 1–10 URLs HTTPS públicas para editar o componer referencias — el mismo endpoint gestiona ambos modos.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 y 3:2. Elige la relación que encaje con tu ubicación — el modelo compone nativamente, sin recortar.
9 créditos por imagen 1K y 18 por 2K. La edición por referencia suma 0,8 créditos por cada imagen extra. estimated_credits es visible antes del polling.
Las tareas 1K típicas tardan unos 15–25 segundos; 2K y multi-referencia, más. Poll el endpoint de estado — las tareas son asíncronas por diseño.
No — y no deberías. Mantén tu clave Bearer en el backend, llama a nuestros endpoints desde el servidor y expón solo tus propias rutas seguras.
Sí — el texto multilingüe en imagen es una de sus fortalezas: pósters, etiquetas de precio y creatividades localizadas con texto legible.
El esquema de petición completo, ejemplos de respuesta, tabla de errores y precios detallados están en /docs/images. Esta página es la visión general de integración.
Obtén una clave API, envía tu primera tarea de generación y conecta la generación de imágenes insignia a tu producto hoy.