POST/api/v1/banners/:id/edits

Corregir y adaptar un banner

Corrige un concepto con una instrucción en lenguaje natural o agrégale tamaños nuevos. Responden 202 con un trabajo.

Son los mismos cambios que haces en el estudio, con el mismo costo en créditos. Los dos endpoints responden 202 con un trabajo: síguelo como el de crear un banner y, al terminar, recibirás el webhook banner.updated (o generation.failed). Requieren el permiso generate y aceptan Idempotency-Key.

Corregir con una instrucción

POST /api/v1/banners/:id/edits cambia el concepto con una instrucción como «botón más grande» y guarda una versión nueva.

CampoRequisitoDescripción

instructionstring

Obligatorio

Qué cambiar, en lenguaje natural. De 1 a 2000 caracteres.

sizesstring[]

Opcional

Cambia solo estos tamaños. Si falta, cambia todos.

modelstring

Opcional

Familia del modelo: haiku, sonnet, opus o fable. Si falta, el del workspace.

Agregar tamaños

POST /api/v1/banners/:id/sizes adapta el concepto a tamaños nuevos y cobra por cada tamaño nuevo, como en la app.

CampoRequisitoDescripción

sizesstring[]

Obligatorio

Tamaños con el formato 300x600. De 1 a 12.

modelstring

Opcional

Familia del modelo, como arriba.

Respuesta · 202

Trae jobId, type (edit o adapt), status, bannerId y las rutas statusUrl y eventsUrl. Con una clave bm_test_ el trabajo ya viene resuelto y no se cobra.

Estado de un trabajoConsulta un trabajo de generación o síguelo en vivo con eventos SSE.Estimar créditosAverigua cuántos créditos costaría una operación y cuál es tu saldo, sin reservar nada.Eventos de webhooksLos 13 eventos, todos emitidos hoy: cuándo salen, qué trae el campo data y un ejemplo de cada uno.

¿Te sirvió esta página?