---
title: "Cover JPEG from a finished project or an uploaded image / video, with a headline."
method: POST
path: "/cover"
tags: ["Tools"]
---

# Cover JPEG from a finished project or an uploaded image / video, with a headline.

`POST /cover`

## Request

- Base URL: `https://wowreveal.com/api/v1`
- URL: `https://wowreveal.com/api/v1/cover`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `projectId` string, uuid
  - `uploadId` string, uuid
  - `atSec` number
  - `headline` string, required
  - `style` 'bold' | 'clean' | 'news' | 'neon', required
  - `format` 'vertical' | 'horizontal' | 'both', required

## Response `200`

Success

- object
  - `files` object[]
    - `url` string
  - `creditsCharged` integer
  - `balance` integer

## Other responses

- `400`: Invalid request (VALIDATION_ERROR and other 400 codes).
- `401`: Missing or revoked API key (INVALID_API_KEY).
- `403`: The plan has no API access, or the account is blocked.
- `429`: Rate limit (RATE_LIMITED) — see the Retry-After header.

---

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