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ámetroTipoObligatorioDescripción
    reference_ad_urlstringURL de la imagen del anuncio de referencia (fuente de estilo) a analizar y replicar.
    product_image_urlstringNoURL de tu imagen de producto subida por el usuario. Proporciona esto y/o product_text.
    product_textstringNoDescripción en texto de tu producto. Opcional junto a product_image_url para más contexto.
    languagestringNoIdioma de salida (p. ej. en, ro, es, fr). Predeterminado: en.
    variant_countnumberNoNúmero de variantes de anuncio (1–6). Predeterminado: 1.
    aspect_ratiostringNop. 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.