Seedream-4.0 Generación de imágenes
- El modelo Seedream 4.0 (doubao-seedream-4.0) soporta modos de generación de texto a imagen, imagen a imagen, edición de imagen y otros
- Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar
- Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente
Autorizaciones
##Todas las APIs requieren autenticación Bearer Token##
Obtener API Key:
Visita la Página de gestión de API Key para obtener tu API Key
Agregar al encabezado de la solicitud:
Cuerpo
Nombre del modelo de generación de imágenes
doubao-seedream-4.0 "doubao-seedream-4.0"
Prompt que describe la imagen a generar, o que describe cómo editar la imagen de entrada, limitado a 2000 tokens
2000"A serene lake reflecting the beautiful sunset scenery"
Especifica el límite superior del número de imágenes a generar, admite cualquier valor entero entre [1,15]
Nota:
-
Si necesita generar múltiples imágenes, incluya en el prompt: "
generate 2 different images" o instrucciones similares -
Cantidad de imágenes de referencia + cantidad final de imágenes generadas ≤ 15
-
Si: cantidad de imágenes de referencia + imágenes requeridas en el prompt > 15, y las imágenes requeridas en el prompt ≤ valor del parámetro n, entonces la cantidad final de imágenes generadas = 15 - cantidad de imágenes de referencia
-
Una solicitud individual se precobrará según el valor de
n, la facturación real se basa en el número de imágenes generadas
1
Tamaño de la imagen generada; admite dos formatos:
Método 1 - Formato de proporción:
auto,1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,21:9,9:21- Junto con el parámetro
quality, el sistema genera automáticamente una imagen con la proporción y resolución correspondientes, sin especificar los píxeles manualmente
Método 2 - Formato en píxeles:
- Ancho x alto, p. ej.:
1280x720,1024x1024,4096x4096 - Rango total de píxeles:
[921600, 16777216] - Rango de relación de aspecto:
[1/16, 16]
"16:9"
Nivel de resolución, utilizado con el formato de proporción de size.
1K, 2K, 4K "2K"
Estrategia de optimización de prompt para configurar el modo de la función de optimización de prompt
Opciones:
standard: Modo estándar, salida de mayor calidad, mayor tiempo de procesamientofast: Modo rápido, mayor velocidad de generación, calidad promedio
standard, fast "standard"
Lista de URLs de imagen de referencia para funciones de imagen a imagen y edición de imagen
Nota:
- Una solicitud admite cantidad de imágenes de entrada:
5imágenes - Tamaño de imagen individual: no más de
10MB - Formatos de imagen admitidos:
.jpeg,.jpg,.png,.webp - Las URLs de imagen deben ser directamente visibles por el servidor, o la URL de imagen debe activar la descarga directa al acceder (generalmente estas URLs terminan con extensiones de archivo de imagen, como
.png,.jpg) - No se admiten imágenes de personas reales
14Dirección de callback HTTPS después de completar la tarea
Momento del callback:
- Se activa cuando la tarea se completa, falla o se cancela
- Se envía después de completar la confirmación de facturación
Restricciones de seguridad:
- Solo se admite el protocolo HTTPS
- El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- La longitud de la URL no debe exceder
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Máximo
3reintentos en caso de fallo (reintentos después de1segundo/2segundos/4segundos) - El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
- La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos
"https://your-domain.com/webhooks/image-task-completed"
Respuesta
Tarea de generación de imagen creada exitosamente
Marca de tiempo de creación de la tarea
1757165031
ID de tarea
"task-unified-1757165031-seedream4d"
Nombre del modelo real utilizado
"doubao-seedream-4.0"
Tipo específico de la tarea
image.generation.task Porcentaje de progreso de la tarea (0-100)
0 <= x <= 1000
Estado de la tarea
pending, processing, completed, failed "pending"
Información de tarea asíncrona
Tipo de salida de la tarea
text, image, audio, video "image"
Información de uso y facturación