Seedream

Seedream solo admite llamadas síncronas, genera 1 imagen por solicitud y devuelve un enlace válido durante 24 horas.

Modelos disponibles

Cómo elegir: solo Pro genera 1K, y en Pro 1.5K cuesta lo mismo que 1K y ofrece mejor calidad, así que prefiera 1.5K; Lite y 4.5 generan como mínimo 2K. El grupo Seedance internacional + Seedream solo ofrece seedream-5-0-pro.

Parámetros de la solicitud

Generar

POST /v1/images/generations con cuerpo JSON. Si añade image, la solicitud pasa a ser una edición de una imagen, una composición de varias o una edición local.

Límites por modelo:

La relación de aspecto de WIDTHxHEIGHT debe estar entre 1:16–16:1. Un size no válido devuelve 400 antes de generar y no se cobra.

Cada elemento de image es una URL http(s) o una Data URL en base64; cada Data URL debe ocupar ≤ 30 MB. Formatos admitidos: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Las URL no se descargan ni se comprueban al enviar, y deben ser direcciones públicas accesibles para el servidor.

La edición local no usa máscara: dibuje la anotación sobre una referencia y describa en el prompt sus coordenadas, cuadro delimitador, flecha o zona pintada.

Editar

POST /v1/images/edits es una entrada compatible para código de edición de OpenAI Images ya existente. Se recomienda multipart/form-data, aunque también acepta el mismo JSON que generations. Requiere al menos 1 imagen de referencia.

Cualquier campo mask devuelve 400, incluso null. Los campos multipart que no aparecen en la tabla se ignoran.

Respuesta

Respuesta síncrona en el JSON estándar de OpenAI Images; la imagen está en data[].url.

{
  "model": "seedream-5-0-pro",
  "created": 1760000000,
  "data": [
    {
      "url": "https://…/result.jpeg?X-Signature=…",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

Ejemplos

Texto a imagen

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-su-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "Calle futurista de noche con neones, encuadre de cine",
    "size": "2048x2048",
    "response_format": "url"
  }'

Editar con referencias

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-su-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "Mueva la taza a la derecha; mantenga el resto",
    "image": ["https://example.com/source.png"],
    "size": "2K",
    "output_format": "png",
    "response_format": "url"
  }'

Notas

• Cada solicitud genera 1 imagen; para más, envíe varias solicitudes.
• Solo síncrono: Prefer: respond-async se ignora y la respuesta sigue siendo síncrona.
• El resultado solo llega como url; no se admite b64_json.
• size no acepta auto, y Lite y 4.5 generan como mínimo 2K.
• seedream-4-5 solo genera JPEG.
• No admite máscaras tradicionales; para editar localmente, use una referencia anotada y descríbala en el prompt.

Errores comunes

Los parámetros no válidos devuelven 400 antes de generar y no se cobran. Un rechazo de seguridad de contenido también devuelve 400 sin cargo, con el motivo en error.message.

model seedream-5-0-pro only supports size 1K, 1.5K, 2K or a valid WIDTHxHEIGHT pixel size   # p. ej. "size": "auto"
model seedream-5-0-lite requires the total pixel count of size to be between 3686400 and 16777216
size aspect ratio must be between 1:16 and 16:1
missing prompt
response_format only supports url
only a single output is supported (n=1)
model seedream-4-5 only supports output_format jpeg
model seedream-5-0-lite only supports optimize_prompt_options.mode standard
optimize_prompt_options must be an object
image must be a URL/data URL string or an array of strings
every item in the image array must be a URL or data URL string
image must not be empty
at most 10 reference images are supported
reference image 1 is invalid: data URL must be base64-encoded
reference image 1 is invalid: unsupported image format image/svg+xml
reference image 1 is invalid: a single image must not exceed 30 MB
image edits require at least one image reference            # /v1/images/edits sin imagen
seedream does not accept a traditional mask; ...            # cualquier "mask" en /v1/images/edits, incluso null

Facturación

Se cobra por imagen de salida, 5.0 Pro también cobra cada imagen de referencia, y las generaciones fallidas y los rechazos de seguridad no se cobran. 5.0 Pro tiene precio por tramo de píxeles de salida, y 1K y 1.5K cuestan lo mismo.

Los precios unitarios están en las fichas de cada modelo y en el catálogo de modelos tras iniciar sesión.

Próximos pasos

• Resumen de generación de imágenes
• GPT Image, imágenes Gemini, imágenes Grok, imágenes Kling
• Referencia de API: Generar imágenes, Editar imágenes
• Si algo falla, revise Solución de problemas