---
title: "Create Thumbnail Generation"
method: POST
path: "/api/v1/channels/{channel}/thumbnails/generations"
tags: ["thumbnails"]
---

# Create Thumbnail Generation

`POST /api/v1/channels/{channel}/thumbnails/generations`

## Request

- Base URL: `https://subscribr.ai`
- URL: `https://subscribr.ai/api/v1/channels/{channel}/thumbnails/generations`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `improvement_mode` false | null, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable
    - `idea_id` integer, nullable
    - `num_variations` integer
    - `prompt` string, nullable, required
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` true, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable, required
    - `idea_id` integer, nullable, required
    - `num_variations` integer
    - `prompt` string, nullable, required
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable, required: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` false | null, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable
    - `idea_id` integer, nullable, required
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` true, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable, required
    - `idea_id` integer, nullable, required
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable, required: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` false | null, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable
    - `idea_id` integer, nullable
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` true, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable, required
    - `idea_id` integer, nullable, required
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable, required: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` false | null, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable
    - `idea_id` integer, nullable
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable: Must use HTTPS.
    - `topic` string, nullable
  - object
    - `improvement_mode` true, nullable, required
    - `clone_strategy` 'direct_reference' | 'style_analysis', nullable, required
    - `callback_secret` string, nullable
    - `callback_url` string, uri, nullable: Must use HTTPS and resolve to a public, non-reserved host; redirects and DNS resolution are revalidated server-side.
    - `feedback` string, nullable, required
    - `idea_id` integer, nullable, required
    - `num_variations` integer
    - `prompt` string, nullable
    - `reference_image_url` string, uri, nullable, required: Must use HTTPS.
    - `reference_variation_url` string, uri, nullable, required: Must use HTTPS.
    - `topic` string, nullable

## Response `202`

Successful response.

- CreateThumbnailGenerationResponse
  - `data` object, required
    - `run_id` string, required
    - `run_ids` string[], required
    - `status` string, required
  - `success` boolean, required

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication is required.
- `403`: The token, role, entitlement, or object policy denies this action.
- `404`: The resource was not found or is not visible.
- `422`: One or more request fields are invalid.
- `429`: The request exceeded a rate limit.
- `500`: The service is temporarily unavailable.

---

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