> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magichour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolution Limits

> How plan tier and per-request resolution work across Magic Hour APIs.

Resolution is per tool. Your plan does not set one pixel size for every endpoint. It gates which
resolution options a given tool will accept. On newer endpoints you pick a named resolution, and
higher values cost more credits on the same plan.

## Named resolutions (the current model)

[Text to video](/api-reference/video-projects/text-to-video) and
[image to video](/api-reference/video-projects/image-to-video) take `480p`, `720p`, `1080p`, or `4k`.
[Image generator](/api-reference/image-projects/ai-image-generator) and
[image editor](/api-reference/image-projects/ai-image-editor) take `640px`, `1k`, `2k`, or `4k`.

What you can pass depends on two things: the model, and your plan.

* **The model** lists the resolutions it actually supports. `sora-2` is 720p only. `kling-3.0` goes
  to 4k. See [models](/api-reference/models).
* **Your plan** gates the highest option you may request. Free is typically the lowest option
  (`480p` / `640px`). Paid plans (Creator, Pro, Business) can request the higher options the model
  supports. You pay more credits for higher resolution; the plan does not charge a flat "Creator
  rate" regardless of size.

A Creator requesting `kling-3.0` at 1080p is allowed and is billed at 72 credits/second. The same
job at 4k is 240 credits/second. That is by design: one plan, multiple resolutions, cost follows
the output.

<Note>
  Defaults follow the plan. Text to video and image to video default to `480p` on Free and `720p` on
  paid. Image `auto` is deprecated and mapped server-side to a resolution the model and your plan
  both support.
</Note>

## Plan vs cost

| Plan     | What you can request                                    | What you pay                          |
| :------- | :------------------------------------------------------ | :------------------------------------ |
| Free     | Lowest option on each tool, plus the models marked free | That option's credit cost             |
| Creator  | Higher options the model supports                       | The selected resolution's credit cost |
| Pro      | Same named-resolution access as other paid plans        | Same, at the selected resolution      |
| Business | Same named-resolution access as other paid plans        | Same, at the selected resolution      |

Creator, Pro, and Business also differ on credits per month, upload size, concurrency, and support.
They do not each lock you to a single pixel size on these endpoints.

Full per-model rates are on [models and credit costs](/api-reference/models).

## Tools that still cap longest edge

Some older image and video endpoints still use a longest-edge pixel cap. Treat these as tool-specific,
not as the plan's identity.

| Plan     | Typical longest edge |
| :------- | :------------------- |
| Free     | 576px                |
| Creator  | 1024px               |
| Pro      | 1472px               |
| Business | 4096px               |

A few of those tools also have a hard cap regardless of plan: AI Headshot Generator (1344px), AI
Clothes Changer (1472px), AI Talking Photo (720p), Video to Video and Animation (1472px). Video to
Video additionally requires width and height divisible by 64.

Those caps are shrinking in importance as more tools move to named resolutions.

## Upgrading

Upgrade when you need a resolution option Free does not unlock, or when higher-resolution jobs
are burning through the monthly allotment and the next plan's credit volume is cheaper than packs.
[Pricing](https://magichour.ai/pricing?ref=docs-resolution-limits) lists current plans.

<Card title="View Pricing Plans" icon="credit-card" href="/billing/subscription-pricing">
  Compare all subscription tiers and their benefits
</Card>