Seedream

​

1. Descripción general

​

Modelos compatibles

​

2. Interfaz y autenticación

POST https://{api_domain}/v3/bytedance/api/v3/images/generations

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

​

3. Parámetros de la solicitud

​

3.1 Parámetros generales

​

3.2 Parámetros específicos del modelo

​

3.3 Ejemplo de texto a imagen

curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "Un golden retriever con una bufanda roja, bajo la luz natural junto a un lago en montañas nevadas, fotografía cinematográfica",
    "size": "2K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": true
  }'

​

3.4 Ejemplo de imagen a imagen

{
  "model": "seedream-4-5-251128",
  "prompt": "Coloque a la persona y la ropa de la imagen de referencia en una escena urbana nocturna unificada, manteniendo las características de la persona consistentes",
  "image": [
    "https://example.com/person.png",
    "https://example.com/outfit.png"
  ],
  "size": "2560x1440",
  "response_format": "url"
}

​

3.5 Ejemplo de serie de imágenes (solo 4.0, 4.5 y 5.0 Lite)

{
  "model": "seedream-5-0-260128",
  "prompt": "Genere tres carteles de las cuatro estaciones con un estilo unificado",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "response_format": "url"
}

​

4. Respuesta

{
  "created": 1786000000,
  "model": "seedream-4-5-251128",
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "2560x1440",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "input_images": 0
  }
}

• Cuando response_format=url, se devuelve data[].url; cuando response_format=b64_json, se devuelve data[].b64_json.
• Seedream 4.0, 4.5 y 5.0 Lite pueden devolver varios elementos data en modo de serie de imágenes.
• Seedream 5.0 Pro devuelve un elemento data en el escenario de generación de imágenes; al activar la descomposición en capas, devuelve varios elementos data (una imagen base + varias capas), y cada elemento incluye adicionalmente el orden de apilamiento de capas z_index (la imagen base es 0), el nombre name, la descripción description y el cuadro delimitador bounding_box (con coordenadas absolute / normalized; la imagen base no devuelve este campo).
• model devuelve el ID de modelo del cliente utilizado en esta solicitud.
• La validez de la URL de la imagen está determinada por la plataforma y el servicio upstream; descargue y guarde las imágenes oportunamente después de recibirlas.

​

5. Restricciones del modelo

​

Seedream 4.0 / 4.5 / 5.0 Lite

• Compatible con generación de texto a imagen, generación de imagen a imagen y generación de series de imágenes.
• Las series de imágenes utilizan sequential_image_generation y sus campos de opciones.
• El número de imágenes de entrada, el tamaño de las imágenes, la resolución y la relación de aspecto se rigen por la documentación upstream del modelo correspondiente. Seedream 4.0 y 4.5 generan siempre salida en JPEG y no admiten el parámetro de solicitud output_format; Seedream 5.0 Lite admite jpeg y png.

​

Seedream 5.0 Pro

• Compatible con generación de texto a imagen, generación a partir de una sola imagen y fusión de múltiples imágenes.
• En el escenario de generación de imágenes, devuelve una imagen exitosa. Al activar la descomposición en capas (layer_decomposition: true), devuelve una imagen base y varias capas (hasta 16 capas), en cuyo caso data contiene varios elementos. No admite la generación de series de imágenes (sequential_image_generation).
• No admite sequential_image_generation ni sequential_image_generation_options.
• size puede usar 1K, 1.5K, 2K o un anchoxalto explícito.
• Al especificar el ancho y el alto de forma explícita, la relación de aspecto y el total de píxeles deben cumplir las restricciones del modelo; las dimensiones reales de la imagen de salida se rigen por data[].size en la respuesta.
• Compatible con la descomposición en capas: al configurar layer_decomposition: true, se descompone una única imagen de entrada en una imagen base y hasta 16 capas editables de forma independiente (cada capa es un PNG con canal alfa). En este escenario, image es obligatorio y solo puede contener una imagen; si se envían varias, se produce un error. La descomposición en capas es de tipo “todo o nada”: si cualquier capa falla, toda la solicitud falla; no se admite el éxito parcial.
• Reglas de size para la descomposición en capas: la resolución de la imagen base es igual a size; la resolución de cada capa es cercana a size, pero cada capa mantiene la relación de aspecto de su región correspondiente en la imagen original, por lo que los píxeles reales de cada capa difieren. Esto significa que las imágenes de salida de una misma solicitud pueden caer en diferentes niveles de precio por píxeles. size puede ser 1K, 1.5K, 2K o auto; por defecto es auto.

​

6. Facturación y uso

• 4.0, 4.5 y 5.0 Lite se facturan según la cantidad de imágenes generadas exitosamente; en la generación de series de imágenes, se calcula según la cantidad de salidas realmente exitosas.
• 5.0 Pro se factura según las imágenes de salida exitosas; con múltiples imágenes de entrada, la primera imagen de referencia es gratuita y las imágenes de referencia adicionales se miden por separado; los diferentes tamaños de salida corresponden a distintos niveles de precio. Al activar la descomposición en capas, la imagen base y cada capa cuentan como una imagen de salida exitosa, y cada una se factura por separado según el nivel de precio correspondiente a los píxeles de su data[].size (por ejemplo, la imagen base en el nivel de alta resolución y algunas capas en el nivel de baja resolución); la factura final es la suma de las cantidades de cada nivel.
• La unidad de uso es “imagen” o item.

​

7. Solución de problemas