Tienes un prompt de Seedream que funciona en una aplicación web y ahora lo quieres en tu propio código. Eso significa una clave API. Hay dos formas de conseguirla: la nube de ByteDance, BytePlus ModelArk, donde creas una clave, eliges un ID de modelo y pagas por imagen; o una plataforma de API que ejecuta Seedream detrás de una sola clave junto con otros modelos. Esta guía cubre ambas, con los pasos exactos, los precios oficiales del 12 de octubre de 2026 y lo que cambia entre una y otra.
Respuesta corta: inicia sesión en la consola de BytePlus, abre la página API keys, haz clic en Create API key y llama a https://ark.ap-southeast.bytepluses.com/api/v3/images/generations con la clave como bearer token y un ID de modelo como dola-seedream-5-0-pro-260628. Seedream 5.0 Pro cuesta $0.045 por imagen hasta 1.5K y $0.09 por encima, Flash $0.018 y Lite $0.035. BytePlus aplica un filtro de contenido por defecto. Una clave de SpicyAPI ejecuta las mismas versiones del modelo Seedream sin filtro añadido, a $0.036 por imagen de 1K para 5.0 Pro, y la misma clave también llama a vídeo y a otros modelos de imagen.
- Un solo modelo, cuenta oficial: BytePlus ModelArk. La vía más barata a Seedream 5.0 Flash.
- Varios modelos, trabajo para público adulto o un precio de Pro más bajo: una clave de plataforma de API como SpicyAPI.
- Páginas de "clave API de Seedream gratis": la lista oficial de precios no tiene cuota gratuita de salida. Las claves compartidas en internet son la cuota de otra persona.
Opción 1: obtener una clave API de Seedream en BytePlus ModelArk
BytePlus es la nube internacional de ByteDance, y ModelArk es su servicio de modelos. Seedream es uno de los modelos de imagen allí, junto con el vídeo Seedance y los modelos de lenguaje Seed. Una cuenta y una clave sirven para todos.
- Crea una cuenta de BytePlus e inicia sesión en la consola. Añade un método de pago antes de depender de ella: según la página oficial de precios, una cuenta que permanece en mora durante dos horas tiene sus servicios de modelos suspendidos hasta que se recargue.
- Abre la página API keys. Si tu organización usa espacios de proyecto, cambia primero al correcto en la esquina inferior izquierda, porque una clave solo llega a los modelos de su propio proyecto.
- Haz clic en Create API key, confirma el nombre y haz clic en Create. La clave aparece en la lista de API keys. Las claves creadas después del 17 de septiembre de 2026 usan un nuevo formato de texto plano; las anteriores siguen funcionando.
- Guarda la clave en una variable de entorno (la documentación usa
ARK_API_KEY) en lugar de ponerla en tu código.
Los pasos oficiales para la clave terminan ahí. La consola también tiene una página Model activation, que muestra tus límites de tasa; varias guías de terceros añaden un paso de activación antes de la primera llamada de imagen, así que si se rechaza una llamada por acceso, esa página es el primer sitio donde mirar.
Después llama al endpoint de imagen con el ID del modelo:
curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "dola-seedream-5-0-pro-260628",
"prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
"size": "2K",
"output_format": "png",
"watermark": false
}'La llamada es síncrona. La respuesta trae un array data, y el url de cada elemento es un enlace de descarga de una imagen. El enlace se conserva solo 24 horas, así que descarga o copia el archivo a tu propio almacenamiento enseguida. Establece response_format en b64_json si prefieres recibir los bytes de la imagen en la respuesta. watermark es true por defecto, lo que añade una marca visible, así que ponlo en false si no la quieres.
Tres cosas más que conviene saber antes de construir sobre esto:
- Restringe cada clave. Una clave puede limitarse a IDs de modelo concretos y a direcciones IP concretas. Una cuenta puede tener hasta 50 claves, así que una clave distinta y restringida por aplicación es un seguro barato contra una fuga.
- Ojo con el límite de tasa. Seedream 5.0 Pro y Flash permiten 500 imágenes por minuto por versión de modelo en una cuenta; por encima de eso, las llamadas devuelven un error.
- La moderación de contenido está activada por defecto. El filtro previo de contenido de ModelArk cubre contenido para adultos y gráfico y está activado en los endpoints nuevos; puedes desactivarlo por endpoint, pero sigue aplicándose una base de políticas de contenido de BytePlus. Las imágenes bloqueadas no se facturan.
IDs de modelo de Seedream en BytePlus
| Modelo | ID de modelo |
|---|---|
| Seedream 5.0 Pro | dola-seedream-5-0-pro-260628 |
| Seedream 5.0 Flash | dola-seedream-5-0-flash-260915 |
| Seedream 5.0 Lite | seedream-5-0-lite-260128 |
| Seedream 4.5 | seedream-4-5-251128 |
| Seedream 4.0 | seedream-4-0-250828 |
BytePlus llama ahora "Dola Seedream" a los modelos 5.0 Pro y Flash. Es la misma línea de modelos. El sufijo de fecha cambia cuando sale una nueva instantánea, así que copia el ID de la lista de modelos en lugar de adivinarlo.
Precios oficiales de la API de Seedream
De la página de precios de ModelArk, consultada el 12 de octubre de 2026:
| Modelo | Salida, por imagen | Imágenes de entrada |
|---|---|---|
| Seedream 5.0 Pro | $0.045 hasta 2.61 MP (1.5K); $0.09 por encima | La primera gratis, después $0.003 cada una |
| Seedream 5.0 Pro, descomposición en capas | $0.0225 hasta 1.5K; $0.045 por encima (por capa) | — |
| Seedream 5.0 Flash | $0.018 | Gratis |
| Seedream 5.0 Lite | $0.035 | Gratis |
| Seedream 4.5 | $0.04 | Gratis |
| Seedream 4.0 | $0.03 | Gratis |
La lista no incluye cuota gratuita de salida. Un lote de 1,000 imágenes de Seedream 5.0 Pro a 2K cuesta $90, y 1,000 imágenes de Flash cuestan $18.
Opción 2: usar Seedream con una sola clave de SpicyAPI
Una plataforma de API te da una clave para muchos modelos y se encarga de las cuentas de proveedor que hay detrás. En SpicyAPI, los pasos son:
- Regístrate y abre API keys en la consola.
- Crea una clave. Puedes limitarla por día, por mes y por toda su vida útil, y restringir qué modelos puede llamar.
- Añade saldo con tarjeta, Apple Pay, Google Pay o criptomonedas. Es un saldo en dólares estadounidenses sin suscripción, y el saldo de pago no caduca.
- Llama al endpoint de tareas con el nombre del modelo:
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
--data '{
"model": "bytedance/seedream-5.0-pro/text-to-image",
"input": {
"prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
"resolution": "2k",
"aspect_ratio": "16:9"
}
}'
Esta llamada es asíncrona: devuelve enseguida un ID de tarea. Consulta GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id> hasta que la tarea termine, o pasa una URL de callback al crearla. Las imágenes terminadas se guardan en el almacenamiento propio de SpicyAPI y se conservan hasta 14 días, tras enlaces firmados, así que no compites contra una caducidad de 24 horas. La referencia de la API detalla los campos, y la página de Seedream 5.0 Pro tiene el esquema de entrada completo, incluidas las ediciones con imágenes de referencia y la descomposición en capas.
Precios por imagen el 12 de octubre de 2026:
| Modelo | SpicyAPI | BytePlus oficial |
|---|---|---|
| Seedream 5.0 Pro, 1K | $0.036 | $0.045 |
| Seedream 5.0 Pro, 2K | $0.072 | $0.09 |
| Seedream 5.0 Lite | $0.0345 | $0.035 |
| Seedream 5.0 Flash | $0.029 | $0.018 |
| Seedream 4.0 | $0.03 | $0.03 |
Pro es un 20% más barato que el precio oficial en ambos tamaños; SpicyAPI ofrece 1K y 2K, no 1.5K. Lite y 4.0 cuestan más o menos lo mismo. Flash cuesta más en SpicyAPI que en BytePlus. Si Flash es todo lo que necesitas y tu contenido encaja en las políticas de BytePlus, la clave oficial es la opción más barata.
La diferencia mayor es lo que devuelve. SpicyAPI no añade ningún filtro de contenido a Seedream. En nuestras pruebas de septiembre, Seedream 5.0 Pro cumplió 33 de 34 ejecuciones de texto a imagen y edición para público adulto, Lite las cumplió las 34 y Flash suavizó un par de las peticiones más fuertes. Los resultados completos están en ¿Seedream no tiene censura?. El propio modelo sigue decidiendo qué dibuja, y que los personajes sean adultos y tener los derechos de cualquier foto que edites siguen siendo responsabilidad tuya.
¿Qué clave deberías conseguir?
| Quieres | Consigue |
|---|---|
| Solo Seedream, sobre todo imágenes generales o comerciales, una cuenta directa con ByteDance | Una clave de BytePlus ModelArk |
| El precio más bajo de Seedream 5.0 Flash | Una clave de BytePlus ModelArk |
| Seedream más vídeo (Seedance, Wan, MiniMax) u otros modelos de imagen bajo una clave y un saldo | Una clave de plataforma |
| Imágenes para público adulto sin un filtro de proveedor por delante | Una clave de plataforma sin filtro añadido, como SpicyAPI |
| Seedream 5.0 Pro a un precio por imagen más bajo | SpicyAPI ($0.036 en 1K) |
También puedes usar ambas: BytePlus para el trabajo general en el que es más barata, y una clave de plataforma para todo lo demás.
¿Y una "clave API de Seedream gratis"?
"Seedream API key free" y "Seedream API key generator" son búsquedas habituales. No existe una clave gratuita oficial. BytePlus cobra cada imagen de salida, y las imágenes de entrada son gratis. Las claves publicadas en GitHub o en foros pertenecen a la cuenta de otra persona. Dejan de funcionar cuando el dueño se da cuenta, y todo lo que construyas sobre una se rompe con ella. Los sitios generadores que prometen una clave gratis o revenden acceso o reparten claves que no son suyas.
La forma honesta más barata de probar es enviar un puñado de imágenes: diez imágenes de Seedream 5.0 Pro a 1K cuestan menos de 50 centavos por cualquiera de las dos vías. En SpicyAPI, las tareas fallidas normalmente no se cobran (cada página de modelo indica si un modelo es una excepción), y el precio de una ejecución se muestra antes de enviarla.
Solución de problemas de una clave nueva
- 401 o "invalid API key": comprueba que la cabecera sea
Authorization: Bearer <key>y que no haya un espacio ni un salto de línea al final en tu variable de entorno. - Errores de acceso o "model not found" en BytePlus: el ID de modelo está mal escrito, la clave está restringida a otros modelos o la clave pertenece a otro espacio de proyecto. Si nada de eso aplica, revisa la página Model activation.
- Errores de contenido en BytePlus: el filtro previo bloqueó el prompt o la salida. No se facturan. Reformular puede ayudar en contenido general límite. Para trabajo para adultos, lee primero la política de uso de BytePlus, porque sus reglas de contenido base se aplican a toda la cuenta incluso con el filtro desactivado.
- Los enlaces dejan de funcionar al día siguiente: las URL de imagen de BytePlus caducan a las 24 horas. Guarda el archivo cuando llegue la respuesta.
- Las llamadas se detienen tras funcionar durante días: revisa el saldo de la cuenta. Una cuenta en mora durante dos horas se suspende hasta que se recargue.
Preguntas frecuentes
¿Dónde encuentro mi clave API de Seedream?
En la consola de BytePlus, en la página API keys. En SpicyAPI, en Console → API keys. En ambas, la lista de claves muestra las que has creado.
¿Es gratis la API de Seedream?
No. En BytePlus se factura cada imagen de salida, desde $0.018 para 5.0 Flash hasta $0.09 para 5.0 Pro por encima de 1.5K. Las imágenes de entrada son gratis, salvo que Seedream 5.0 Pro cobra $0.003 por cada imagen de entrada después de la primera.
¿Cuál es el ID de modelo de Seedream 5.0?
En BytePlus, dola-seedream-5-0-pro-260628 para Pro, dola-seedream-5-0-flash-260915 para Flash y seedream-5-0-lite-260128 para Lite. En SpicyAPI, bytedance/seedream-5.0-pro/text-to-image y los nombres equivalentes para Flash, Lite y ediciones.
¿Puedo usar la API de Seedream para imágenes NSFW?
No con los ajustes por defecto de BytePlus: el filtro previo de contenido bloquea el contenido para adultos, y las políticas de contenido de BytePlus se aplican incluso con él desactivado. En SpicyAPI no hay filtro añadido, y Seedream 5.0 Pro y Lite cumplieron casi todas nuestras pruebas para público adulto.
¿Seedream 4.5 o 5.0?
En BytePlus, 5.0 Lite ($0.035) cuesta menos que 4.5 ($0.04), y 5.0 Flash ($0.018) cuesta menos que cualquiera de los dos. Pro es el que merece pagar más, cuando la calidad de imagen es lo principal. Nuestra comparativa Lite vs Pro vs Flash tiene resultados lado a lado.
En resumen
Conseguir una clave API de Seedream en BytePlus lleva unos minutos: crear una clave, usar el ID de modelo correcto, guardar cada imagen en 24 horas y vigilar el saldo. Es la vía más barata a Seedream 5.0 Flash y la adecuada para trabajo general con una cuenta directa de ByteDance. Si quieres Seedream junto a otros modelos de imagen y vídeo bajo una clave, un precio de Pro más bajo, resultados que siguen disponibles hasta dos semanas o imágenes para público adulto sin un filtro de proveedor, una clave de SpicyAPI lo cubre.
