# News Reel Video API

> Turn the latest story on a topic, or your own article, into a vertical news reel with real credited photos, a headline card or tabloid cover, and an optional voiceover in 39 languages.

- Canonical page: https://www.autofeed.ai/video-api/news-reel
- API reference: https://www.autofeed.ai/docs/api
- Publisher: AutoFeed.ai (https://www.autofeed.ai)

Send a topic and AutoFeed finds the latest story on it, or send the article yourself. It writes a short script from that text only, finds a real photo for each beat, and returns a branded vertical reel.

- Real photos per beat, each credited on screen, never AI images
- Headline card or tabloid cover, in your brand name and colour
- Your own article as the only source, or the latest story found for you
- Voiceover with captions, or music only

## Example request

Costs 1,000 credits, the same as in the dashboard.

```bash
curl -X POST https://www.autofeed.ai/api/v1/videos \
  -H "Authorization: Bearer $AUTOFEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "news_reel",
    "input": {
      "topic": "The biggest celebrity moments of the week",
      "layout": "tabloid",
      "tone": "gossip",
      "brandName": "Daily Buzz",
      "kicker": "EXCLUSIVE"
    },
    "webhookUrl": "https://example.com/webhooks/autofeed",
    "idempotencyKey": "order-1042-news-reel"
  }'
```

202 Accepted:

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

`video.completed` webhook body:

```json
{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "news_reel",
  "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"
}
```

## Input fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `topic` (required) | string (max 500) | - | Required. The beat or the story. Without sourceText, the latest article on it is found for you. |
| `sourceText` | string (max 20000) | - | Your article. When present, no search runs and every fact and quote comes from this text. |
| `layout` | "card" \| "tabloid" | "card" | "card" (headline card over the photos) or "tabloid" (big cover, then photos). |
| `tone` | "gossip" \| "news" \| "business" | "gossip" | "gossip", "news" or "business". |
| `language` | one of 39 values | "English (USA)" |  |
| `brandName` | string (max 40) | "Daily Buzz" |  |
| `brandColor` | string | "#1652c8" | A hex colour such as "#1652c8". |
| `kicker` | string (max 24) | "" (none) | A short pill over the headline, such as "BREAKING". Empty lets the script choose. |
| `targetSeconds` | integer 15-90 | 30 |  |
| `voice` | string \| "none" | "pNInz6obpgDQGcFmaJgB" | An ElevenLabs voice id, or "none" for a music-only reel without captions. |
| `music` | string (max 255) | "none" |  |
| `captionStyle` | one of 17 values | "Pop" |  |
| `customCaptions` | object | - |  |
| `captionSize` | "Small" \| "Medium" \| "Large" | "Medium" |  |
| `captionPosition` | "Top" \| "Center" \| "Bottom" | "Center" |  |

Included with Ultimate. Rendered files are kept for 14 days.

## Frequently asked questions

### Where do the photos come from?

For each beat, real photos are searched in Wikimedia Commons and in web image search, then copied to our storage for the render. Each one carries an on-screen credit. Check that your use of the photos suits your publishing rights.

### Can I make a reel from an article I already have?

Yes. Send the text as sourceText. No news search runs, and quotes that are not verbatim in your text are dropped.

### How is a News Reel 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. News Reels are a flat price.
