---
title: "Create a snack pack"
method: POST
path: "/api/v1/snacks"
tags: ["Snacks"]
---

# Create a snack pack

`POST /api/v1/snacks`

## Request

- Base URL: `https://www.vidguy.ai`
- URL: `https://www.vidguy.ai/api/v1/snacks`
- Auth: HTTP bearer

Async — kicks off a snack generation job for a brand. Returns a jobId immediately. Optionally renders the snacks server-side when `render: true` (+3 credits, URLs in `result.renderedAssets[]`).

## Request body

- CreateSnackRequest
  - `brandId` string, uuid, required
  - `name` string
  - `callbackUrl` string, uri
  - `render` boolean: When true, also render PNGs/MP4s server-side. Adds +3 credits. URLs land in result.renderedAssets[].
  - `exclude` string[]: Snack types to skip. Still supported with `types`; exclusions are subtracted after the allow-list is applied.
  - `types` string[]: Positive snack-type allow-list. Use with `count` for packs like 5 greenscreen memes or 5 slide carousels.
  - `count` integer: Total snacks to request. When `types` has one value, all requested snacks use that type.
  - `context` string: Per-request creative steer woven into the snack copy and asset selection.
  - `prompt` string: Alias for `context`.

## Response `201`

Snack job accepted.

- CreateSnackResponse
  - `jobId` string, required
  - `offeringId` 'snack_generation', required
  - `status` 'queued' | 'processing' | 'awaiting_selection' | 'completed' | 'failed' | 'cancelled', required
  - `pollUrl` string, required
  - `instanceId` string, nullable
  - `creditsReserved` integer, required
  - `render` boolean
  - `exclude` string[]
  - `types` string[]
  - `count` integer
  - `snackTypeSequence` string[]

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Insufficient credits.
- `404`: Brand not found.
- `429`: Rate limit exceeded.
- `502`: Failed to dispatch the worker.

---

[API](https://skmtc.dev/vidguy/apis/vidguy-snacks-api.md) · [All operations](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/revisions/ad6855539a1a?raw)