API Reference
API pública por marca. Creá la clave en Dashboard → API y MCP. Para agentes de IA usá también MCP remoto.
Autenticación
Las rutas /api/v1/* se autentican con la clave de desarrollador de la marca (no el JWT de la web):
Authorization: Bearer ab_live_… Content-Type: application/json
La Conversions API de la tienda usa otra clave (ab_capi_…) en /api/capi/event.
Notificaciones
Usa GET, PATCH y DELETE sobre /api/notifications con el JWT del usuario. Los detalles de parámetros figuran en la tabla de endpoints más abajo.
Endpoints
/api/v1/meMarca, scopes y estado de Meta de la clave.
Params: —
/api/v1/campaignsLista campañas de Meta de la marca.
Params: limit
/api/v1/campaigns/:idPausa, activa, presupuesto o nombre.
Params: { status } | { dailyBudgetUsd } | { name }
/api/v1/campaigns/:id/insightsMétricas de una campaña.
Params: datePreset=last_7d
/api/v1/campaigns/:id/adsAnuncios de una campaña.
Params: —
/api/v1/ads/:idPausa o activa un anuncio.
Params: { status: ACTIVE|PAUSED }
/api/v1/studio/generateGenera imagen o vídeo (créditos).
Params: { type, prompt, model?, aspectRatio?, duration? }
/api/v1/studio/copyGenera copy publicitario (créditos).
Params: { product, audience, platform?, language? }
/api/capi/eventConversions API de la tienda (clave ab_capi_).
Params: { event } | { events }
Conversions API (tienda)
Clave distinta, generada en Marca → Conversions API. No sirve para MCP ni para /api/v1.
POST /api/capi/event Authorization: Bearer ab_capi_…
Rate Limits
- Lectura /api/v1: 100 peticiones / minuto por clave.
- Escritura Meta: 30 peticiones / minuto por clave.
- Studio (generate/copy): 20 peticiones / hora por clave.
- MCP: 120 peticiones / minuto por clave.
- CAPI: 600 peticiones / minuto por clave de ingesta.
Cuando excedes el límite, recibirás HTTP 429 con header Retry-After.
Modelos disponibles (Studio)
| Key | Nombre | Tipo |
|---|---|---|
| seedream-4 | SeedDream 4 (ByteDance) | Imagen |
| gpt-image-2 | GPT Image 2 (OpenAI) | Imagen |
| nano-banana-pro | Nano Banana Pro (Google) | Imagen |
| nano-banana-2 | Nano Banana 2 (Google) | Imagen |
| seedance-2 | Seedance 2.0 (ByteDance, kie.ai) | Video |
| kling-v3 | Kling V3 (Kuaishou, kie.ai) | Video |
| grok-imagine-video | Grok Imagine Video (xAI, kie.ai) | Video |
| sora-2-i2v | Sora 2 I2V (OpenAI, WaveSpeed.ai) | Video |
| sora-2-pro-i2v | Sora 2 Pro I2V (OpenAI, WaveSpeed.ai) | Video |
| veo-3.1-lite-i2v | Veo 3.1 Lite (Google, WaveSpeed.ai) | Video |