Herramientas de anuncios
Genera creatividades publicitarias con dos entradas: (1) una imagen de anuncio de referencia (URL) cuyo estilo analiza y replica la IA, y (2) tu producto — imagen de producto subida por el usuario (URL), descripción en texto, o ambos. La IA replica el estilo de referencia y produce varias variantes con tu producto.
#create_ad_copy
Inicia una generación de creatividades: el sistema analiza la imagen de anuncio de referencia y genera variantes con tu producto. Proporcionas una URL de imagen de referencia y un producto como URL de imagen, texto, o ambos (imagen + texto, como en la app web, enriquece el perfil del producto en el orquestador).
Parámetros:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| reference_ad_url | string | Sí | URL de la imagen del anuncio de referencia (fuente de estilo) a analizar y replicar. |
| product_image_url | string | No | URL de tu imagen de producto subida por el usuario. Proporciona esto y/o product_text. |
| product_text | string | No | Descripción en texto de tu producto. Opcional junto a product_image_url para más contexto. |
| language | string | No | Idioma de salida (p. ej. en, ro, es, fr). Predeterminado: en. |
| variant_count | number | No | Número de variantes de anuncio (1–6). Predeterminado: 1. |
| aspect_ratio | string | No | p. ej. 9:16, 16:9, 1:1. Predeterminado: 9:16. |
Ejemplo (imagen de referencia + imagen de producto subida):
{
"reference_ad_url": "https://example.com/reference-ad.jpg",
"product_image_url": "https://example.com/my-product.png",
"language": "en",
"variant_count": 3,
"aspect_ratio": "9:16"
}
Ejemplo (imagen de referencia + solo texto de producto):
{
"reference_ad_url": "https://example.com/reference-ad.jpg",
"product_text": "Crema facial orgánica, tarro de cristal 50 ml",
"variant_count": 2,
"aspect_ratio": "1:1"
}
Ejemplo (imagen de referencia + imagen y texto de producto, como en la web):
{
"reference_ad_url": "https://example.com/reference-ad.jpg",
"product_image_url": "https://example.com/my-product.png",
"product_text": "Crema facial orgánica, tarro de cristal 50 ml — SKU estrella",
"variant_count": 3,
"aspect_ratio": "9:16"
}
Respuesta: Incluye project_id, generation_ids (uno por variante), status, y a menudo un resumen analysis y estimated_time_seconds. Consulta cada ID con get_generation_status (igual que medios) hasta completarse; luego usa las URLs de imagen de salida.
Consejos: Para mejores resultados, usa una imagen de referencia de alta calidad y una imagen de producto clara (p. ej. fondo limpio).
Consulta Limitaciones para límites de ritmo y créditos.
