Media

A Media Asset is an AI-generated image or video created from a prompt and billed from an account balance. When generation finishes, the asset includes a file that can be attached anywhere Whop accepts files. Use the Media API to start a generation job and retrieve the asset while it processes or after it is ready.

Endpoints

Endpoint	Request
Retrieve Media Asset	GET `/media/{id}`
Generate Media Asset	POST `/media/generate`

Attributes

string

required

Media asset ID, prefixed media_.

number | null

required

USD amount charged to the account’s balance for this generation. null if the generation wasn’t billed.

string | null

required

ISO 8601 timestamp when the asset reached a terminal state. null while processing.

string

required

ISO 8601 timestamp when the generation was requested.

string

required

Currency of amount_charged. Always usd.

string | null

required

Why generation failed. null unless status is failed.

object | null

required

The produced file, usable anywhere attachments are accepted. null until the asset is ready.

Properties

string

required

File ID, prefixed file_.

string

required

CDN URL for downloading the file.

object

required

The inputs the asset was generated from.

Properties

number | null

required

Requested video length in seconds. null for images.

string

required

What the asset was generated from.

string[]

required

Reference image file IDs (file_ prefixed) supplied at generation time.

string | null

required

Requested video resolution. null for images. 1080p is not supported by Seedance 2.0 Fast or Mini; 4k is only supported by Seedance 2.0.Available options: 480p, 720p, 1080p, 4k

string

required

The kind of media this asset holds.Available options: video, image

string

required

How the asset was created. Always generated.Available options: generated

string

required

Lifecycle state: processing while generation runs, ready when the file is available, failed when generation failed and the charge was refunded.Available options: processing, ready, failed

MediaAsset

{
	"id": "media_xxxxxxxxxxx",
	"amount_charged": 0.25,
	"completed_at": "2026-06-01T12:01:30Z",
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"error_message": null,
	"file": {
		"id": "file_xxxxxxxxxxxx",
		"url": "https://img.whop.com/file_xxxxxxxxxxxx.png"
	},
	"generation": {
		"duration_seconds": null,
		"prompt": "A clean product mockup on a white background",
		"reference_media": [],
		"resolution": null
	},
	"media_type": "image",
	"source": "generated",
	"status": "ready"
}

Introduction

Reference

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Identity

Developer

Media

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes