> ## Documentation Index > Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt > Use this file to discover all available pages before exploring further. # Generate video with MiniMax H3 Max > MiniMax H3 Max — the post-trained H3 variant tuned for stronger prompt adherence and aesthetics, with native audio. Text-to-video; image-to-video (start and/or end frame); reference-to-video mixing up to 5 reference images, up to 3 reference video clips (2-15s each, 15s combined — billed per second of INPUT, see POST /v1/cost) and up to 3 reference audio clips (free); and video extension (supply a `video` to continue it). 480p/768p/1080p (2K when extending), any duration 5-15 seconds. Priced per output second by resolution (see `resolution_pricing` in GET /v1/models); reference images beyond the first two add a small per-image charge. **Asynchronous.** Returns a job `id` (the video is not in this response). Poll [`GET /v1/videos/{id}`](/api-reference/videos/get-video-job-status) until `status` is `succeeded` — the video URL is in that response's `video_url`. Examples, sample output and pricing: [MiniMax H3 Max](https://budgetpixel.com/models/minimax-h3-max) ## OpenAPI ````yaml /openapi.yaml post /videos/minimax-h3-max openapi: 3.1.0 info: contact: email: support@budgetpixel.com name: BudgetPixel Support description: > The BudgetPixel developer API for programmatic image, video, music and sound-effect generation. Generation is **asynchronous**: you create a job, then poll its status until it reaches a terminal state (`succeeded` / `failed`). You are charged in credits only on success — never for failures, timeouts, or content blocked before generation. **Authentication.** All requests require an API key sent as a bearer token: Authorization: Bearer bpx_live_xxx Create and manage keys from your BudgetPixel account dashboard. The developer API is available on **every paid plan**. On the **Free** plan, API keys can call one endpoint: `GET /v1/stock/images`, the free stock image library search. **Pricing.** API usage is metered in credits at each model's published price (see `GET /v1/models`), and your plan's model discounts and active promotions apply to API charges exactly as they do on the web — `POST /v1/cost` quotes your discounted price. Pro and Ultra plans include a daily free-models allowance (a shared pool of free generations per day across qualified image models such as FLUX 2 Klein and Qwen-Image) that covers API requests too — the standard price applies once the day's pool is used. Other promotional free daily generations remain web/app-only. Failed generations are never charged. **Rate limits.** Requests are limited per minute: **600 requests/min per API key** and **1200 requests/min per source IP** (defaults; subject to tuning). Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (seconds until the window resets). Exceeding a limit returns HTTP `429` with a `Retry-After` header — wait that long before retrying. Rejected requests still count against the window, so a tight retry loop keeps you limited; back off instead. Generation jobs additionally have a per-plan concurrency cap (the same one as the web workshop), independent of these request limits. `POST /v1/uploads` also has a dedicated **60 uploads/min per account** cap (it's free/unmetered) on top of these limits. title: BudgetPixel API version: '2026-06-20' servers: - description: Production url: https://api.budgetpixel.com/v1 security: - ApiKeyAuth: [] tags: - description: Account and credit balance name: Account - description: Discover available models and pricing name: Models - description: Upload input media for image/video generation name: Uploads - description: Image job status name: Images - description: FLUX image models name: Black Forest Labs - description: SeeDream image models name: Bytedance - description: Video job status name: Videos - description: Kuaishou Kling video models name: Kling - description: SeeDance video models name: ByteDance (SeeDance) - description: Music and sound-effect job status name: Audios - description: Music generation models name: Music - description: Text-to-sound-effect models (priced per second) name: Sound Effects - description: Format conversion for images, video, and audio name: Conversions - description: Publish posts to your BudgetPixel feed name: Social - description: Content moderation — NSFW rating and CSAM detection name: Moderation - description: Content classification — music genre detection name: Classification - description: >- Search the free stock image library — available on every plan, including Free name: Stock Images paths: /videos/minimax-h3-max: post: tags: - MiniMax summary: Generate video with MiniMax H3 Max description: >- MiniMax H3 Max — the post-trained H3 variant tuned for stronger prompt adherence and aesthetics, with native audio. Text-to-video; image-to-video (start and/or end frame); reference-to-video mixing up to 5 reference images, up to 3 reference video clips (2-15s each, 15s combined — billed per second of INPUT, see POST /v1/cost) and up to 3 reference audio clips (free); and video extension (supply a `video` to continue it). 480p/768p/1080p (2K when extending), any duration 5-15 seconds. Priced per output second by resolution (see `resolution_pricing` in GET /v1/models); reference images beyond the first two add a small per-image charge. **Asynchronous.** Returns a job `id` (the video is not in this response). Poll [`GET /v1/videos/{id}`](/api-reference/videos/get-video-job-status) until `status` is `succeeded` — the video URL is in that response's `video_url`. Examples, sample output and pricing: [MiniMax H3 Max](https://budgetpixel.com/models/minimax-h3-max) operationId: createVideo_minimax_h3_max requestBody: content: application/json: schema: properties: aspect_ratio: description: >- Aspect ratio. Text-to-video uses it directly; image-to-video follows the frame image and ignores it; reference-to-video also accepts "adaptive" (the default there); extension accepts "auto" (follow the source — the default there) or a ratio to crop to. Defaults: 16:9 for text-to-video. enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '21:9' - adaptive - auto type: string audio: description: >- Optional soundtrack (≥2s, ≤15MB, MP3/WAV) pinned to a text-to-video or image-to-video output: it replaces the generated audio, trimmed to the video length. Provide a public audio URL or an uploaded-file URL from POST /v1/uploads. Not available with reference media or `video`. type: string x-bpx-media: audio end_image: description: >- Optional last frame. With `image` the video interpolates between the two frames; on its own it is an end-keyframe generation. Same input forms as `image`. type: string x-bpx-media: image image: description: >- Optional first frame for image-to-video — the output follows its framing. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with reference media or `video`. type: string x-bpx-media: image length_seconds: default: 5 description: >- Output length in seconds (5-15). When extending, the seconds of NEW footage appended to the source. maximum: 15 minimum: 5 type: integer prompt: description: >- Text description of the video. In reference mode, address assets by order: "Image 1", "Video 1", "Audio 1". When extending, describe what happens next, not the source. type: string reference_audios: description: >- Optional reference audio clips (up to 3; each 2-15s, 15s combined; WAV/MP3) for sound/voice guidance, addressed as "Audio 1"… Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Free. Can't be combined with `image`/`end_image`. items: type: string maxItems: 3 type: array x-bpx-media: audio reference_images: description: >- Optional reference images (up to 5) for subjects/style in reference-to-video mode, addressed in the prompt as "Image 1", "Image 2"… The first two are free; each additional image adds 50 credits. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with `image`/`end_image`. items: type: string maxItems: 5 type: array x-bpx-media: image reference_videos: description: >- Optional reference video clips (up to 3; each 2-15s, 15s combined; MP4/MOV, ≤50MB each) for motion/identity guidance, addressed as "Video 1"… Each item is a public video URL or an uploaded-file URL from POST /v1/uploads (passed by URL, not inlined). Billed at 170 credits per second of INPUT on top of the output — estimate via POST /v1/cost. Can't be combined with `image`/`end_image`. items: type: string maxItems: 3 type: array x-bpx-media: video resolution: default: 768p description: >- Output resolution. Pricing varies by resolution — see `resolution_pricing` in GET /v1/models. 2k is only available when extending a `video`. enum: - 480p - 768p - 1080p - 2k type: string seed: description: Seed for reproducible generation. Omit for random. type: integer video: description: >- Optional video to EXTEND (1.6-60s, ≤50MB, aspect ratio between 2:5 and 5:2). The model continues it for `length_seconds` of new footage guided by `prompt`, and the output is the source followed by the continuation. Provide a public video URL or an uploaded-file URL from POST /v1/uploads. Can't be combined with any other media input. The source is billed at 170 credits per second (first 15 seconds) — estimate via POST /v1/cost. type: string x-bpx-media: video required: - prompt type: object required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/CreateVideoResponse' description: Job accepted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' components: schemas: CreateVideoResponse: properties: id: description: Opaque job id — use it to poll status. type: string message: type: string model: type: string status: $ref: '#/components/schemas/JobStatus' type: object JobStatus: description: Lifecycle state. `succeeded`/`failed`/`timeout` are terminal. enum: - pending - starting - processing - completing - succeeded - failed - timeout type: string Error: properties: error: properties: code: description: Stable machine-readable code. example: model_not_available type: string message: type: string type: description: Error category. example: invalid_request_error type: string required: - type - code - message type: object required: - error type: object ModerationBlocked: description: >- Returned (with HTTP 400) when the input content moderation gate blocks a generation request. The block is a property of the request's prompt or input media — reword the prompt or change the input and retry. Branch on `restriction_reason`, which is stable and machine-readable. properties: error: description: Human-readable explanation of the block. type: string restriction_reason: description: Stable machine-readable block reason. enum: - input_csam - input_explicit_adult - input_upload_nudity - input_celebrity_likeness - strict_model_nsfw type: string required: - error - restriction_reason type: object responses: BadRequest: content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/ModerationBlocked' description: >- The request was malformed, referenced an unavailable model, or was blocked by input content moderation (moderation blocks carry a `restriction_reason` — see ModerationBlocked). Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. Forbidden: content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Authenticated but not permitted (plan gate, ownership, account restriction). Content-moderation blocks are 400, not 403. TooManyRequests: content: application/json: schema: $ref: '#/components/schemas/Error' description: Rate or queue limit reached. Retry after a short delay. securitySchemes: ApiKeyAuth: bearerFormat: bpx_live_* description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx' scheme: bearer type: http ````