Volver a Documentación

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

GET/api/v1/me

Marca, scopes y estado de Meta de la clave.

Params: —

GET/api/v1/campaigns

Lista campañas de Meta de la marca.

Params: limit

PATCH/api/v1/campaigns/:id

Pausa, activa, presupuesto o nombre.

Params: { status } | { dailyBudgetUsd } | { name }

GET/api/v1/campaigns/:id/insights

Métricas de una campaña.

Params: datePreset=last_7d

GET/api/v1/campaigns/:id/ads

Anuncios de una campaña.

Params: —

PATCH/api/v1/ads/:id

Pausa o activa un anuncio.

Params: { status: ACTIVE|PAUSED }

POST/api/v1/studio/generate

Genera imagen o vídeo (créditos).

Params: { type, prompt, model?, aspectRatio?, duration? }

POST/api/v1/studio/copy

Genera copy publicitario (créditos).

Params: { product, audience, platform?, language? }

POST/api/capi/event

Conversions 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)

KeyNombreTipo
seedream-4SeedDream 4 (ByteDance)Imagen
gpt-image-2GPT Image 2 (OpenAI)Imagen
nano-banana-proNano Banana Pro (Google)Imagen
nano-banana-2Nano Banana 2 (Google)Imagen
seedance-2Seedance 2.0 (ByteDance, kie.ai)Video
kling-v3Kling V3 (Kuaishou, kie.ai)Video
grok-imagine-videoGrok Imagine Video (xAI, kie.ai)Video
sora-2-i2vSora 2 I2V (OpenAI, WaveSpeed.ai)Video
sora-2-pro-i2vSora 2 Pro I2V (OpenAI, WaveSpeed.ai)Video
veo-3.1-lite-i2vVeo 3.1 Lite (Google, WaveSpeed.ai)Video