AutoFeed API

AI UGC Ad Video API

Send a hook line, pick an avatar and point at your product footage. AutoFeed renders the reaction, the hook overlay and your demo into one vertical ad.

58 AI avatar reaction clips to choose from
Your hook text on screen, up to 300 characters, styled how you want
Your own product demo in the same ad, or the reaction on its own
Vertical 1080x1920, flat price per ad

One Request

This exact body passes the live API schema and costs 1,000 credits, the same as making it in the dashboard.

Request

curl -X POST https://www.autofeed.ai/api/v1/videos \
  -H "Authorization: Bearer $AUTOFEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ugc",
    "input": {
      "hook": "I cancelled four subscriptions after finding this app",
      "avatarSrc": "/ugc-templates/1.mp4",
      "demoSrc": "https://example.com/media/app-demo.mp4"
    },
    "webhookUrl": "https://example.com/webhooks/autofeed",
    "idempotencyKey": "order-1042-ugc-ads"
  }'

202 Accepted

{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "ugc",
  "status": "processing",
  "costInCredits": 1000,
  "createdAt": "2026-11-02T12:00:00.000Z"
}

Webhook: video.completed

{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "ugc",
  "status": "completed",
  "error": null,
  "costInCredits": 1000,
  "createdAt": "2026-11-02T12:00:00.000Z",
  "completedAt": "2026-11-02T12:03:41.000Z",
  "url": "https://.../1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11.mp4"
}

A UGC ad render, made by the pipeline this API calls.

Every Input Field

Read from the API's own schema. Unknown fields are rejected with a 400, never silently dropped.

Field	Type	Default	Notes
`hook`required	string (max 300)	-	Required. The line shown on screen over the avatar.
`avatarSrc`	one of 58 values	"/ugc-templates/1.mp4"	Which avatar clip to use, by its path. The dashboard shows every option.
`demoSrc`required	string (max 2048)	-	An https URL to your product footage. Empty means no demo. Private and local addresses are rejected.
`soundId`	one of 77 values	"none"
`hookAlignment`	"start" \| "center" \| "end"	"center"
`hookConfig`	object	preset	Text styling for the hook. Any field you leave out comes from the preset.

What It Costs

The API is included with Ultimate and spends the same credits as the dashboard. Ultimate's 180k monthly credits cover about 180 requests like the one above. Rendered files are kept for 14 days.

See every Ultimate size →

UGC Ads API Questions

Is the avatar a talking-head lip-sync?

No. The avatar is a pre-made reaction clip with your hook text over it, combined with your demo if you send one. There is no script read aloud and no lip-sync.

Where does my demo video need to be?

At a public https URL we can fetch. URLs that point at private, local or link-local addresses are rejected before anything is charged.

How is a UGC ad billed?

From the same credit balance as the dashboard, at the same price per video. The cost is in the 202 response before any work starts, and a failed render refunds it. UGC ads are a flat price.

What the UGC Ads API returns