ByteDance
Seedream 5.0
seedream-5.0-pro/image-to-image
Modelo de generación de imágenes de nivel de producción de ByteDance, compatible con búsqueda en internet y razonamiento lógico de varios pasos, salida en 4K y edición por ejemplos, ideal para crear imágenes de productos e infografías
Probar seedream-5.0-pro/image-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
seedream-5.0-pro/image-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.060 |
| 2K | $0.100 |
Descripción general
La línea de edición de imágenes de Seedream 5.0 Pro toma imágenes de referencia como entrada y realiza modificaciones de imagen y composición de múltiples imágenes según el prompt. En una sola llamada se pueden pasar de 1 a 10 imágenes de referencia y obtener imágenes finales con resolución 1K o 2K, 8 relaciones de aspecto y dos formatos: png y jpeg. Está orientado a desarrolladores que necesitan aplicar intenciones de edición textuales sobre material existente, por ejemplo, cambiar el estilo, sustituir el fondo o combinar varias imágenes manteniendo la coherencia del sujeto; es adecuado para integrarse en flujos de producción masiva como material de comercio electrónico e imágenes de marketing.
Puntos clave
- Composición con múltiples referencias: una sola solicitud puede incluir hasta 10 imágenes de referencia, lo que permite realizar fusión y edición combinada de varias imágenes en una misma generación.
- Resolución y relación de aspecto seleccionables: la salida admite dos niveles, 1K para pruebas rápidas y 2K para resultados detallados, y ofrece 8 relaciones de aspecto que cubren formatos horizontales, verticales y cuadrados.
- Edición guiada por prompt: describe el objetivo de la modificación con un prompt de 3 a 4000 caracteres, sin necesidad de montar en el servidor una cadena adicional de procesamiento de imágenes.
Descripción de capacidades
Edición con múltiples referencias: se pasan de 1 a 10 imágenes JPEG, PNG o WebP como base de edición (cada imagen no debe superar los 10MB; no se admite SVG); el modelo realiza la edición o la composición de varias imágenes a partir de ellas, lo que resulta adecuado para sustituir el origen del material en lugar de volver a ejecutar la generación de texto.
Control de resolución y relación de aspecto: la salida puede ser 1K o 2K, con un límite aproximado de 2048x2048 para 2K; las relaciones de aspecto cubren 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 y 21:9, lo que facilita ajustar directamente el tamaño de cada ubicación publicitaria.
Formato de salida especificable: el resultado generado puede especificarse como png o jpeg, lo que facilita que el lado de integración lo adapte directamente a los procesos posteriores de almacenamiento, compresión y distribución.
Casos de uso
- Operaciones de comercio electrónico: edición a partir de fotografías reales del producto: sube varias imágenes del producto y describe los ajustes de escena y estilo para obtener resultados listos para la página de detalles o la imagen principal.
- Equipos de marketing: composición de imágenes promocionales con múltiples materiales: pasa juntas imágenes del producto e imágenes de escena, y mediante la fusión de varias imágenes obtén banners o imágenes para redes sociales, exportadas directamente con la relación de aspecto de cada plataforma.
- Creadores de contenido: reescritura de estilo de imágenes existentes: toma la imagen original como referencia y describe el estilo objetivo para generar una serie de imágenes con estilo uniforme, destinadas a la actualización visual de secciones y portadas.
Limitaciones y recomendaciones de selección
Solo admite edición de imagen a imagen; la solicitud debe incluir al menos 1 imagen de referencia y no puede utilizarse como línea de generación de imágenes a partir de texto puro. Las imágenes de referencia están limitadas a JPEG, PNG y WebP, no se admite SVG y cada una no debe superar los 10MB. La resolución máxima de salida es 2K; si se necesitan resultados de nivel de impresión con más píxeles, debe optarse por otra solución. Si la tarea parte únicamente de texto para generar imágenes, debe elegirse un modelo de generación de imágenes a partir de texto de la misma serie; en escenarios que exijan un control a nivel de píxel sobre el resultado de la reescritura de estilo, se recomienda mantener una revisión humana.
Novedades
Ver el registro de cambios →- Nuevo modelo seedream-5.0-pro/image-to-image ya disponible
- Nuevo modelo Nuevo modelo disponible: seedream-5.0-pro/text-to-image
- Nuevo modelo Modelo seedream-5.0-lite/image-to-image ya disponible
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: seedream-5.0-pro/image-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para seedream-5.0-pro/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 3maxLength 4000Texto de instrucción que describe el efecto de edición deseado o el contenido de la imagen a generar; debe tener entre 3 y 4000 caracteres.
image_urlsarrayObligatoriominItems 1maxItems 10Arreglo de URL de imágenes de referencia, usado para edición de imágenes o composición de varias imágenes; el número de elementos va de 1 a 10; admite formatos JPEG, PNG y WebP (no admite SVG); el tamaño máximo por imagen es de 10 MB.
Array [ string ]
resolutionstringObligatorioPredeterminado: "2K"Resolución de la imagen de salida: 1K equivale a unos 2 megapíxeles, adecuada para iteraciones rápidas; 2K equivale a unos 4 megapíxeles y puede alcanzar hasta 2048x2048, adecuada para requisitos de detalle más finos. Valor predeterminado: 2K.
1K2Kaspect_ratiostringObligatorioPredeterminado: "1:1"Relación de aspecto de la imagen generada. Valor predeterminado: 1:1.
1:14:33:416:99:162:33:221:9output_formatstringOpcionalPredeterminado: "png"Formato de la imagen de salida. Valor predeterminado: png.
pngjpegcallbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.0-pro/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "png"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-5.0-pro/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "png"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedream-5.0-pro/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "png"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FASHN Tryon v1.6 FASHN $0.107 /imagen -
Nano Banana 2 Lite Google $0.033 /imagen -
Grok Imagine xAI $0.011 /segundo -
851 Labs Background Remover 851 Labs $0.002 /imagen -
Wan 2.7 Image Alibaba $0.035 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
Nano Banana Pro Google $0.057 /imagen -
Qwen Image 2.1 Alibaba $0.020 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
Nano Banana Google $0.021 /imagen -
Grok Imagine Image 2.0 xAI $0.052 /imagen





