Seedream 5.5

Utilice el modelo doubao-seedream-5-5-261028 con POST https://apimaster.ai/v1/images/generations, un cuerpo JSON y Authorization: Bearer YOUR_API_KEY. Cree su clave APIMaster en la consola.

Admite texto a imagen, edición con hasta diez referencias, edición sucesiva, salida RGBA transparente nativa, descomposición en capas y OCR de texto enriquecido. La generación normal devuelve una imagen. La descomposición devuelve una base y capas separadas. No se admiten streaming, generación secuencial de imágenes ni búsqueda web. Utilice el endpoint síncrono; permita al menos 300 segundos antes de un tiempo de espera del cliente y evite el reenvío a ciegas.

Precios base oficiales

Verificado con los precios de Volcengine el 2026-11-13. La conversión configurada era de 7 CNY por USD.

Elemento	CNY por imagen	Precio base aproximado en USD
Cada referencia de entrada, incluida la primera	0.05	0.00714286
Salida con ancho × alto ≤ 2,610,000 píxeles	0.13	0.01857143
Salida superior a 2,610,000 píxeles	0.23	0.03285714

La generación y la descomposición usan las mismas tarifas de salida. Cobre cada base/capa por separado usando su data[].size real; el borde más largo no determina el nivel. 2048x1024 está en el nivel inferior. Dos entradas más una salida de nivel alto cuestan CNY 0.33 antes de los multiplicadores de cuenta/canal. A diferencia de Seedream 5.0 Pro, la primera referencia no es gratuita. Los cargos reales de la cuenta incluyen los coeficientes aplicables de canal/grupo de usuarios y el redondeo de cuota a entero. Consulte la tarjeta del modelo en vivo y los registros de uso.

Texto a imagen

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Parámetros

Campo	Tipo / predeterminado	Reglas
model	string obligatorio	doubao-seedream-5-5-261028.
prompt	string	Obligatorio para la generación; opcional para la descomposición. Describa el contenido, el estilo, la relación de aspecto, el texto o la ubicación de la edición. La guía oficial de redacción recomienda ≤300 caracteres chinos o ≤600 palabras en inglés; esto es una guía, no un límite de bytes.
image	string o string[]	URL pública o data:image/png;base64,.... Hasta diez referencias de generación; exactamente una entrada para la descomposición. Las rutas del sistema de archivos local no funcionan.
size	string	La generación usa por defecto 2K; 1K, 1.5K, 2K o WIDTHxHEIGHT exacto. La descomposición usa por defecto auto, solo acepta auto y estos tres niveles.
output_format	string, png	png o jpeg. Para la descomposición, esto controla solo la base; las capas siempre son PNG.
background	string, auto	auto, transparent o opaque, solo para generación. La salida transparente requiere PNG; omita este campo por completo para la descomposición.
response_format	string, url	url o b64_json. Lea el campo correspondiente en cada elemento data[].
watermark	boolean, true	Establezca false para omitir la marca de agua visible de generación por IA.
optimize_prompt_options	object	Solo {"mode":"standard"} es compatible con 5.5; fast no es compatible.
layer_decomposition	boolean, false	Habilite la descomposición de una imagen PNG/JPEG.
layer_decomposition_options	object	Opciones de descomposición a continuación.
layer_decomposition_options.max_images	integer, 30	2–100, incluida la base. Un máximo, no un recuento garantizado.
layer_decomposition_options.text_recognition	boolean, false	Solicite OCR de texto enriquecido para capas de texto normal.
safety_identifier	string	Identificador de usuario estable en inglés, de como máximo 64 caracteres; use un hash en lugar de información de contacto personal.

No use resolution, quality, n ni seed de otro modelo para controlar este modelo. No se enumeran como sus controles de generación correspondientes en la API oficial. Establezca los límites de descomposición con layer_decomposition_options.max_images.

Tamaños y restricciones de entrada

Para la generación normal, elija un nivel (1K, 1.5K, 2K) y describa la relación de aspecto en el prompt, o proporcione dimensiones exactas. El área de salida exacta debe ser 921,600–4,624,220 píxeles, con relación de aspecto 1:16–16:1, cumpliendo ambas restricciones. 2880x1440 es válido; 512x512 es demasiado pequeño. No existe un nivel 4K.

La descomposición no acepta dimensiones exactas. Con auto, los tamaños de base/capa dentro del rango admitido conservan sus dimensiones originales cuando es posible; los elementos más pequeños/más grandes se escalan hacia 1K/2K preservando su relación de aspecto. Las capas devueltas pueden ocupar distintos niveles de facturación.

Restricción de entrada	Generación/edición	Descomposición
Cantidad	Hasta 10	Exactamente 1
Formatos	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Tamaño de archivo por imagen	≤30 MB	≤30 MB
Área en píxeles	196–36,000,000; ambos lados >14 px	262,144–36,000,000
Relación de aspecto	1:16–16:1	1:16–16:1

Use tipos MIME en minúsculas en las URL de datos. Las URL de entrada remotas deben ser accesibles para el servicio.

Edición e imágenes transparentes

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Para una entrada, image puede ser una cadena. Para ediciones sucesivas, pase explícitamente la salida anterior como la siguiente entrada: esto no es una conversación con estado y cada solicitud se factura por separado. Describa coordenadas/cuadros/flechas en el prompt o dibuje marcas en la referencia; no hay un parámetro de posicionamiento mask documentado por separado para esta interfaz.

Para la generación transparente nativa, omita image si no es necesario y establezca background: "transparent", output_format: "png", con un prompt como «una mariposa de cristal azul translúcido, recurso aislado, fondo transparente». La edición puede usar hasta diez referencias; no es necesario que ya tengan canales alfa. transparent más jpeg no es válido. El background de una respuesta describe la transparencia real (transparent o opaque).

Descomposición y OCR de texto enriquecido

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Admite una base más hasta 99 capas. max_images: 4 incluye la base. Omita background; cada capa es un PNG transparente. Un fallo de una capa individual hace fallar toda la solicitud en lugar de devolver un éxito parcial.

Lea todas las entradas data[]:

• url/b64_json, size y output_format identifican el artefacto y sus dimensiones reales; background está disponible cuando corresponde.
• z_index: 0 identifica la base; los índices mayores aparecen por encima de los menores.
• name y description describen la capa.
• bounding_box.absolute es [left,top,right,bottom] en píxeles de la base de salida. Cambie el tamaño de una capa a (right-left) × (bottom-top) y colóquela en (left,top); las dimensiones del archivo de la capa pueden diferir de su huella en el lienzo.
• bounding_box.normalized usa coordenadas 0–1000. Multiplique las coordenadas horizontal/vertical por el ancho/alto del lienzo de destino y divida por 1000..
• text_recognition aparece solo cuando se solicita y la capa contiene texto normal reconocido. La escritura a mano, las letras artísticas y las capas sin texto pueden omitirlo.

El OCR contiene text y lines[]; cada línea tiene su propio bounding_box y runs[] con estilo. Cada fragmento tiene text y style, que pueden contener similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow y translucent. Estas son interpretaciones visuales aproximadas, no propiedades exactas del diseño original; el reconocimiento de fuentes puede devolver unknown.

Respuesta, almacenamiento y fallos

La respuesta contiene created, model, data[], usage.input_images y usage.generated_images. El recuento generado incluye la base y las capas. Conserve los metadatos completos de la respuesta. Las URL de descarga originales del proveedor caducan después de 24 horas; descargue/archive sus recursos con prontitud.

Corrija las dimensiones no válidas, los recuentos de referencias o las opciones de transparencia incompatibles antes de reintentar. Gestione la autenticación, los permisos, la moderación, los límites de tasa y los fallos del proveedor por separado; nunca interprete un error como una generación exitosa. Los límites de IPM cuentan las imágenes generadas por cuenta/versión del modelo; la descomposición reserva max_images y devuelve la capacidad no utilizada después de completarse, mientras que la facturación usa las imágenes producidas reales.

Fuentes oficiales: Seedream 5.5, API de generación de imágenes, precios. Parámetros verificados el 2026-11-13.