Introduction

The moan.hot API sells ready-made video, image and storyboard effects over plain HTTP. You send a photo and the slug of an effect, we run the tuned GPU pipeline behind it, and you get a finished file back by webhook or by polling. Every effect in the catalogue is already proven with paying users, so you ship a product instead of building a generation stack.

Who it is for

Founders and developers who want to sell AI video effects inside their own app, site or bot, under their own brand. You do not need GPUs, model tuning, ComfyUI workflows or a moderation pipeline. You need an HTTP client and a webhook endpoint.

How it works

1. Pick an effect. GET /effects returns the catalogue with every variant (duration, resolution, audio, frame prep), its fixed price, typical time to result, and sell-ready assets: localised names, descriptions, posters and preview clips you can show in your own UI.
2. Upload an image with POST /files, or pass a public https:// image URL directly.
3. Create a generation with POST /generations. The price is held on your prepaid balance and the job is queued. You get 202 Accepted at once.
4. Get the result. We send generation.succeeded to your webhook with signed output URLs. The hold becomes a charge only when the output is stored. If anything fails on our side, the hold is released and you pay nothing.

The basics

Base URL	https://api.moan.hot/v1
Auth	Authorization: Bearer mh_test_... or mh_live_...
Format	JSON in and out; uploads are multipart/form-data
Money	Integer micro-USD in every *_micros field. 1000000 is $1.00
Time	RFC 3339 UTC strings
Ids	Prefixed strings: gen_, file_, eff_, evt_
Errors	RFC 9457 application/problem+json with a stable code
Lists	Cursor pagination with limit, starting_after, ending_before and has_more
Versioning	/v1 only changes additively. Breaking changes go to /v2

Where to go next

• Quickstart: a test key, a first generation and a webhook in about ten minutes.
• API reference: every endpoint and schema, generated from the OpenAPI contract.
• AI assistants: hand these docs and the spec to your coding assistant.