AutoFeed API

Would You Rather Video API

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

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": "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

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

Webhook: video.completed

{
  "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"
}

A Would You Rather 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
`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"

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 →

Would You Rather API 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.

What the Would You Rather API returns