ToAPIs
    HomeToAPIs
    Image GenerationGPT Image 2.6, Gemini, FLUX…Video GenerationSeedance, Veo, Kling, Sora…Chat & WritingGPT-5.6, Claude, DeepSeek…Speech & MusicVoiceover, TTS, Audio
    New ReleaseSeedance 2.5
    PricingAPI DocsMCP
    BlogAlternatives
    Log InStart Free
    All ModelsPricingAPI DocsMCPBlogAlternatives
    Log InStart Free

    Language

    Esc
    • Seedance 2.5Video Generation
    • GPT Image 2Image Generation
    • GPT Image 2.6Image Generation
    • GPT Image 2.5Image Generation
    • Veo 3.1 FastVideo Generation
    • Kling 3.0 TurboVideo Generation
    • Kling V4 FlashVideo Generation
    • Grok Video 1.5Video Generation
    • Nano Banana 2Image Generation
    • Seedream 5.5Image Generation
    • FLUXImage Generation
    • Sora 2Video Generation
    • All Image ModelsCategory
    • All Video ModelsCategory
    • GPT-5.6 SolChat & Coding
    • Claude Opus 4.8Chat & Coding
    • Claude Opus 4.7Chat & Coding
    • DeepSeek V4 ProDeepSeek · Text
    • Gemini Omni 1.1 FlashGoogle · Multimodal

    Quick Answer

    • minimax-h3 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
    • Use this model guide page to validate parameters with minimal request/response examples.
    • Stabilize prompts here first, then move to production API integration.

    Key Parameters

    • model | string | required | MiniMax-H3 | - | Model identifier. Use the fixed value `MiniMax-H3`.
    • prompt | string | required | - | - | Main instruction describing the subject, action, scene, and style.
    • aspect_ratio | string | optional | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive | Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive`.
    • duration | integer | optional | 5 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Output duration in seconds. Defaults to `5`; supports `4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`.
    • resolution | string | optional | 2K | 2K | 768p | Output resolution. Defaults to `2K`; supports `2K | 768p`.

    Common Errors

    • 400 invalid_request_error: trigger=Request payload misses required fields or has invalid field types.; fix=Validate model, mode, and input schema before request.; retry=Retry only after fixing payload; avoid blind retries.
    • 401 authentication_error: trigger=Missing Authorization header or invalid API key.; fix=Verify Bearer token format and API key scope.; retry=Retry after auth fix; rotate key if repeated failures continue.
    • 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
    • 500 internal_error: trigger=Transient upstream error or internal processing failure.; fix=Capture request id and trigger retry workflow.; retry=Retry 2-3 times with short delays; escalate if persistent.

    minimax-h3

    minimax-h3 is provided by MiniMax with Video capabilities. Current pricing reference: 20.8 credits /second. This page helps you understand positioning, parameters, and production-ready use cases before integration.

    Model Type:
    Text To VideoImage To VideoMultimodal Reference
    Pricing: current pricing unavailable
    Production route
    Live
    PlaygroundSimilarREADMEAPI

    Input

    FormJSON

    Reference images

    Describe subject, camera, scene, and style.146 / 1200

    Advanced options

    Example params

    Output

    PreviewJSON

    Your video result appears here

    Video generation can take longer. Submit and wait for polling to finish.

    View API DocsGet API Key

    Generation takes some time. Please wait.You can leave this page. [ Task Logs ] lets you check the generated content directly.

    Request preview

    {
      "model": "MiniMax-H3",
      "prompt": "A 6-second product concept video generated with minimax-h3: a futuristic city street, slow camera push-in, natural light, stable cinematic motion.",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "size": "16:9",
      "aspect_ratio": "16:9",
      "metadata": {
        "prompt_optimizer": true
      },
      "watermark": false
    }

    Transparent pricing

    minimax-h3 pricing

    Video usage is billed according to the current duration and resolution rules. Final billing follows the current account quote.

    Top up credits
    20.8 credits /second

    Why ToAPIs

    Why call minimax-h3 through ToAPIs?

    Keep video generation, API keys, billing, and task tracking in one workflow.

    Unified multi-mode testing

    Switch across Text-to-Video, Image-to-Video, R2V, and Video Edit in one place.

    Parameter-first validation

    Iterate quickly on prompts, durations, and references before production rollout.

    Production-ready handoff

    Minimal request/response structure helps you move stable configs into API workflows.

    Connect in three steps

    Create a key, submit a video task, and poll the result.

    1. 1

      Step 1

      Fill prompt and key parameters.

    2. 2

      Step 2

      Run, inspect output structure, then iterate.

    3. 3

      Step 3

      Move stable settings into production API.

    When to use minimax-h3

    Use case 1

    When you need fast iteration across multiple generation modes.

    Use case 2

    When you need to validate parameters and error handling before integration.

    FAQ

    minimax-h3 FAQ

    When should I use minimax-h3?

    Use it to validate video concepts quickly, compare mode behavior, and converge prompts before API rollout.

    How do I choose Text-to-Video vs Image-to-Video?

    Use Text-to-Video when you only have instructions; use Image-to-Video when you already have key frames or composition.

    What is the difference between R2V and Video Edit?

    R2V focuses on reference-guided generation, while Video Edit focuses on modifying existing video assets.

    Image or video model error: invalid apitype: -1

    This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.

    An image or video task failed, but the user was still charged

    Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.

    minimax-h3 API

    Start building with minimax-h3

    Test a video request here, then continue in the dashboard or API documentation.

    Start for freeView API Docs

    Try minimax-h3 with one ToAPIs key.

    Use one account and API surface for video generation workflows.

    Sign up to get free credits
    Developer Guides

    Related Guides & Tutorials

    Learn how to integrate and build with minimax-h3 in production.

    tutorial5 min

    Engineering tutorial for an automated Reference-to-Video pipeline on MiniMax H3: first-frame inputs, asset staging, bounded task polling, and the ToAPIs frontend request contract.

    ToAPIs Engineering & Evaluation Team2026-11-10T14:00:00+08:00
    ToAPIs
    HomeToAPIs
    Enterprise AI API Gateway. Access GPT-5, Claude, Gemini and 200+ models through one unified API.

    Popular Models

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Show moreShow less
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • All models

    API Categories

    • AI Image API
    • AI Video API
    • Text-to-Video API
    • Image-to-Video API
    Show moreShow less
    • AI Image Editing API
    • LLM & Reasoning API
    • All API tools →

    Alternatives

    Alternatives
    • Kie.ai alternative
    • Fal.ai alternative
    • OpenRouter alternative
    • Replicate alternative
    • Wavespeed AI alternative
    • All comparisons →

    Featured Guides

    Featured Guides
    • Seedance 2.0 vs 2.5 pricing
    • Cheapest Seedance API guide
    • MiniMax H3 integration guide
    • Free Seedance 2 API key
    • Seedance 2 API quickstart
    • All engineering posts →

    Developers & Platform

    Developers & Platform
    • API documentation
    • MCP
    • Pricing
    • Model playground
    • LLMs.txt
    • Contact support
    • Model guide directory
    Operating entity:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Registered office:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacyTermsAcceptable UseData DeletionData RetentionSubprocessors & RegionsBilling & RefundsCookie PolicySitemapAbout

    © 2026 ToAPIs. All rights reserved.

    tutorial
    5 min

    The MiniMax H3 Prompting Guide: How to Craft Cinematic Camera Movements via API

    Developer guide to writing cinematic camera-movement prompts for the MiniMax H3 video API on ToAPIs, including reusable templates, cURL/Python examples, and the current frontend request contract.

    ToAPIs Engineering & Evaluation Team2026-11-10T10:00:00+08:00
    tutorial10 min

    MiniMax H3 API Guide: Text-to-Video and Reference Inputs

    A practical guide to calling MiniMax H3 video models through ToAPIs, with request examples, supported input modes, model-specific limits, and polling guidance.

    ToAPIs Engineering Team2026-10-22T09:00:00+08:00
    View all posts
    Building an Automated Image-to-Video (R2V) Pipeline Using the MiniMax H3 API