# Would You Rather Video API

> Generate "Would You Rather" quiz videos from a topic with one API call: 1 to 10 illustrated matchups, a voiceover and background music, in 9:16, 16:9 or 1:1.

- Canonical page: https://www.autofeed.ai/video-api/would-you-rather
- API reference: https://www.autofeed.ai/docs/api
- Publisher: AutoFeed.ai (https://www.autofeed.ai)

Send a topic and a number of matchups. AutoFeed writes the dilemmas, illustrates both sides of each one, reads them out and returns the video.

- 1 to 10 matchups per video, 8 by default
- Two generated images per matchup, with optional background removal
- Voiceover and background music included
- Aspect ratios 9:16, 16:9, 1:1

## 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": "would_you_rather",
    "input": {
      "topic": "Superpowers with a catch",
      "numberOfComparisons": 8,
      "format": "9:16"
    },
    "webhookUrl": "https://example.com/webhooks/autofeed",
    "idempotencyKey": "order-1042-would-you-rather"
  }'
```

202 Accepted:

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

`video.completed` webhook body:

```json
{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "would_you_rather",
  "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 2000) | - | Required. The theme every matchup is written around. |
| `numberOfComparisons` | integer 1-10 | 8 | Enforced at 1-10 by the API. The format is flat-priced, so the count does not change the cost. |
| `removeBackground` | boolean | false | Removes the background from each generated image. Doubles the image work, same price. |
| `music` | string (max 255) | "solitude" |  |
| `voice` | string | "pNInz6obpgDQGcFmaJgB" |  |
| `format` | "9:16" \| "16:9" \| "1:1" | "9:16" |  |

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

## Frequently asked questions

### Does a longer quiz cost more?

No. Would You Rather is flat-priced: 1 matchup and 10 matchups cost the same credits.

### How is a Would You Rather video 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.