img_uuid y luego realice un sondeo o utilice una devolución de llamada HTTPS para obtener el resultado en 2K.API de Seedream 4.0 para la generación de imágenes
Acceda a Seedream 4.0 a través de la API abierta e independiente de GoEnhance. Envíe solo un prompt de texto o añada hasta 14 imágenes de referencia, reciba un
Crear una clave de API
Elija el modo de entrada de Seedream 4.0
Texto a imagen a partir de un prompt enfocado
Envíe un prompt obligatorio de 1 a 2000 caracteres. Omita image_list para una generación pura de texto a imagen.
Generación de imágenes guiada por referencia
Añada de 1 a 14 URL de imágenes públicas en image_list cuando su flujo de trabajo necesite una guía de imagen a imagen.
Un flujo de trabajo REST asíncrono
Utilice un único endpoint para ambos modos de entrada. Un envío exitoso devuelve un identificador de tarea en lugar de bloquearse hasta que la imagen esté lista.
Valide la estructura de la solicitud antes del envío y realice un seguimiento de cada imagen como una tarea asíncrona.
Capacidades y límites de la API de Seedream 4.0
Validación de prompt
<code>prompt</code> es obligatorio y acepta de 1 a 2000 caracteres.
Siete relaciones de aspecto documentadas
Establezca <code>ratio</code> en <code>1:1</code>, <code>4:3</code>, <code>3:4</code>, <code>16:9</code>, <code>9:16</code>, <code>3:2</code> o <code>2:3</code>. Omítalo para usar el valor predeterminado del modelo.
Imágenes de referencia opcionales
Pase de 1 a 14 objetos en <code>image_list</code>, cada uno con una URL de imagen pública, o omita el campo para texto a imagen.
Salida 2K
La ruta documentada de Seedream 4.0 devuelve imágenes generadas en resolución 2K.
Autenticación Bearer
Envíe su clave de API de GoEnhance en el encabezado <code>Authorization</code> y manténgala fuera del código y los registros del lado del cliente.
Finalización mediante sondeo o devolución de llamada
Conserve el <code>img_uuid</code> devuelto, luego realice un sondeo de los detalles del trabajo o reciba actualizaciones del estado de la tarea en una URL de devolución de llamada HTTPS pública.
La referencia actual de la API de GoEnhance enumera un token por imagen de Seedream 4.0.
Precios de la API de Seedream
$0.02 por imagen generada
GoEnhance lista Seedream 4.0 a 1 token por imagen, con 1 token equivalente a $0.02.
Presupuesto sencillo a nivel de solicitud
Estime el costo como el número de tareas de imagen enviadas multiplicado por $0.02; no se realiza ningún cálculo por segundo para este endpoint de imagen.
Verifique la facturación actual antes de ejecutar procesos de producción
Revise la página de facturación en vivo de GoEnhance antes de realizar grandes lotes, ya que los términos de la cuenta y los precios de la plataforma pueden cambiar.
Integrar la API de Seedream 4.0
1
1. Cree y proteja una clave de API
Cree una clave en /keys y envíela con la solicitud. No la exponga en el código del navegador ni en repositorios públicos.
2
2. Construya y valide la solicitud
Añada el prompt requerido, elija una relación de aspecto opcional e incluya
image_list solo cuando tenga de 1 a 14 URL de referencia accesibles. 3
3. Envíe y guarde el img_uuid
Realice un POST a
https://api.goenhance.ai/api/v1/seedream-4-0. Guarde el img_uuid devuelto con su registro de trabajo interno. 4
4. Realice sondeos o reciba devoluciones de llamada
Realice sondeos a
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., o proporcione una custom_callback_url para notificaciones de estado HTTPS. 5
5. Maneje los resultados terminales de forma idempotente
Compruebe tanto el estado HTTP como el
code/msg de la respuesta. Corrija las solicitudes no válidas antes de volver a enviarlas y evite el procesamiento duplicado en etapas posteriores.Conecte la generación de prompts, referencias, seguimiento de trabajos asíncronos, almacenamiento y revisión humana en una sola canalización de imágenes.
Qué construyen los desarrolladores con Seedream 4.0
Canalizaciones creativas de productos
Genere conceptos de escenas de productos a partir de prompts estructurados y dirija las salidas seleccionadas hacia flujos de trabajo de revisión y campaña.
Exploración de marca guiada por referencias
Utilice imágenes de referencia aprobadas para guiar la composición o la dirección visual sin necesidad de crear un endpoint de edición de imágenes independiente.
Variantes de campaña localizadas
Adapte mediante programación los detalles del prompt para mercados, formatos y canales, manteniendo un seguimiento consistente de las tareas.
Arte conceptual y previsualización
Cree imágenes fijas en 2K para la exploración de estados de ánimo, guiones gráficos, estudios de entorno y decisiones creativas tempranas.
Precios, entradas, proporciones, resultados, gestión de trabajos y relación con la plataforma.