Guía API Seedream 5 Pro

API Seedream 5 Pro para generación de imágenes IA

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.

Resolución
1K / 2K

Salida 1K o 2K

Relaciones de aspecto
7

1:1 a 16:9, 9:16, 2:3, 3:2

Entradas
T2I + I2I

Prompt o hasta 10 imágenes de referencia

Interfaz
REST

JSON sobre HTTPS

Petición inicial

Crear una tarea de imagen Seedream 5 Pro

seedream-5-pro
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.

Por qué integrar la API Seedream 5 Pro

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.

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.

Un alias de modelo estable

Llamas a model "seedream-5-pro". El enrutado, la capacidad y los fallbacks quedan de nuestro lado — tu integración no sufre cambios upstream.

Precio en créditos predecible

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.

Capacidades de la API Seedream 5 Pro

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.

Generación texto-a-imagen

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.

Edición multi-referencia

Pasa 1–10 URLs HTTPS públicas en image_urls para editar, componer o reestilizar visuales existentes — cambio de producto, fondo, transferencia de estilo.

Salida en alta resolución 2K

Pon resolution en "2k" para renders con calidad de impresión y assets finales. 1K cubre previews e iteraciones.

Texto multilingüe en imagen

Una de sus mayores fortalezas — texto legible en inglés, chino, japonés y más dentro de pósters y rótulos.

Arquitectura de trabajos asíncronos

La creación devuelve task_id al instante. Poll el estado a tu ritmo y mantén la UI receptiva — sin conexiones largas.

Respuestas independientes del proveedor

El formato de respuesta se mantiene estable sea cual sea el enrutado upstream — consumed_credits, status y URLs de imagen están normalizados.

Cómo llamar a la API Seedream 5 Pro

Tres pasos desde la clave API hasta la URL de imagen final.

1

Crear una clave API

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.

2

Enviar una tarea de generación

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.

3

Poll y renderiza

Llama a GET /v1/images/generations/:task_id. Cuando status llegue a SUCCESS, lee images[0].url y muestra o archiva el resultado.

Referencia de endpoints

Dos endpoints cubren todo el ciclo — crear y hacer polling.

POST /v1/images/generations

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.

GET /v1/images/generations/:task_id

Devuelve IN_PROGRESS, SUCCESS con images[].url o FAILED con objeto de error. También informa consumed_credits al terminar.

Errores y límites

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ámetros de la petición

ParámetroValor
modelDebe ser "seedream-5-pro" — el único modelo público en esta ruta.
promptPrompt de texto o instrucción de edición, 1–3000 caracteres.
aspect_ratioUno 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_urls0–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 en créditos

Precio fijo por imagen en créditos de Seedance API. La respuesta de creación incluye estimated_credits; el estado final informa consumed_credits.

ModoCréditosNotas
Texto-a-imagen · 1K9 créditos / imagenResolución por defecto — para iteraciones y previews.
Texto-a-imagen · 2K18 créditos / imagenCalidad de impresión para assets finales.
Edición por referencia+0,8 créditos / imagen extraPrimera referencia incluida; las imágenes 2–10 suman 0,8 cada una.

FAQ API Seedream 5 Pro

Respuestas para desarrolladores que evalúan la API Seedream 5 Pro en Seedance API.

¿Es esta la API oficial de ByteDance Seedream 5 Pro?

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.

¿Qué diferencia hay entre texto-a-imagen y edición por referencia?

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.

¿Qué relaciones de aspecto soporta Seedream 5 Pro?

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.

¿Cuánto cuesta una imagen Seedream 5 Pro?

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.

¿Cuánto tarda una generación?

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.

¿Puedo llamar a esta API desde el navegador?

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.

¿Seedream 5 Pro renderiza texto dentro de las imágenes?

Sí — el texto multilingüe en imagen es una de sus fortalezas: pósters, etiquetas de precio y creatividades localizadas con texto legible.

¿Dónde está la documentación API completa?

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.

Crea tu primera imagen Seedream 5 Pro

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.