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

    • Supports prompt-based text-to-image workflows for marketing and creative assets.
    • Supports reference-guided generation for stronger style consistency.
    • Stabilize parameters in this guide first, then move into production API.

    Key Parameters

    • model | string | required | minimax-h3-image | - | Exact model identifier from ToAPIs.
    • prompt | string | required | - | - | Primary image instruction prompt.
    • size | string | optional | 1:1 | - | Output aspect ratio, model-dependent.
    • n | integer | optional | 1 | - | Number of generated images per request.
    • reference_images | file[] | optional | - | - | Reference images for style consistency.

    Common Errors

    • 400 invalid_request_error: trigger=Missing or invalid payload fields.; fix=Validate model/prompt/size payload fields.; retry=Retry only after payload fix.
    • 401 authentication_error: trigger=Missing or invalid API key.; fix=Verify Authorization header and key scope.; retry=Retry after authentication fix.

    MiniMax H3 Image

    Text-to-image and reference-image editing. Default 4K, 1–10 outputs, up to 16 HTTP(S) reference images.

    Model Type:
    Text To ImageImage To Image
    Pricing: MiniMax H3 Image $2.14/1M tokens
    Text input $2.14/1M tokens· Image input $1.43/1M tokens· Image output $3.57/1M tokens
    PlaygroundSimilarREADMEAPI
    1

    Describe your image

    Reference images

    Describe the image you want to generate.34 / 1200

    Advanced options

    Example params
    Watermark
    Disable Prompt Enhanced
    2

    Your generated result

    Your image result appears here

    Sign in to submit a generation task.

    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-image",
      "prompt": "A ceramic teapot on a wooden table",
      "response_format": "url",
      "resolution": "4K",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }

    Transparent pricing

    Token pricing

    Billed on actual text input, image input and image output tokens, not a fixed price per image. Final charges follow successful output usage.

    Top up credits

    Text input

    ToAPIs

    $2.14

    1M tokens

    Image input

    ToAPIs

    $1.43

    1M tokens

    Image output

    ToAPIs

    $3.57

    1M tokens

    SpecificationToAPIs priceBilling basis
    Text input

    ToAPIs

    $2.14

    1M tokens

    1M tokens
    Image input

    ToAPIs

    $1.43

    1M tokens

    1M tokens
    Image output

    ToAPIs

    $3.57

    1M tokens

    1M tokens

    Why ToAPIs

    MiniMax H3 Image

    Text-to-image and reference-image editing. Default 4K, 1–10 outputs, up to 16 HTTP(S) reference images.

    Workflow

    MiniMax H3 Image runs as an async image task on ToAPIs: submit, poll, download.

      Workflow

      FAQ

      Frequently asked questions

      How is usage billed?

      Billed on actual text input, image input and image output tokens, not a fixed price per image. Final charges follow successful output usage.

      Which input and output formats are available?

      JSON requests with HTTP(S) references and URL results. JPEG (default), PNG or WebP output. No Base64, multipart, native SSE, masks or transparent background. Editing always enables prompt enhancement.

      MiniMax H3 Image API

      MiniMax H3 Image

      Try MiniMax H3 Image in the playground, or read the API reference to integrate text-to-image and reference editing into your image pipeline.

      View pricingDocumentation

      MiniMax H3 Image

      One API covers text-to-image and reference-image editing, billed per token with 4K output by default.

      View API docs
      Developer Guides

      Related Guides & Tutorials

      Learn how to integrate and build with MiniMax H3 Image in production.

      tutorial6 min

      Developer guide to the MiniMax Hailuo 2.3 video API on ToAPIs: human-motion prompt patterns, the current request contract for 6/10-second 768P and 1080P jobs, and cURL/Python examples.

      ToAPIs Engineering & Evaluation Team2026-11-11T10: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

      Building an Automated Image-to-Video (R2V) Pipeline Using the MiniMax H3 API

      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
      tutorial5 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
      View all posts
      MiniMax Hailuo 2.3 API Integration: Generating Complex Human Motion in AI Video