Minimax API Key Free: Integration Guide, Pricing & Code

Ask “minimax api key free” and the current results tell you almost nothing useful: an official docs page that never mentions the word free, a Reddit thread where someone pastes a real subscription key, and a site with a MiniMax-shaped domain that is not MiniMax. The word “free” is doing a lot of work in this query, and most of it is wishful.

Here is the honest version, with prices read from the official pages on August 18, 2026: creating a MiniMax API key costs nothing and the official quick start does not require a card just to create one — but there is no universal free API tier, and every paid model bills against your balance. The genuinely free parts — the official free music endpoints, which MiniMax has announced it will discontinue on August 20, 2026 — the paid prices, the third-party free routes that actually exist, and the traps to avoid are all below, with code you can run.

Can you get a MiniMax API key for free?

Yes — in the narrow sense that matters at setup time. The official Quick Start guide walks through register, create a secret key under API Keys, and top up “if needed.” Creating the key is free; no credit card is documented as a requirement to create it. The cost starts when you call a paid model.

What is not free is the API itself. MiniMax documents no universal free developer tier and no signup-credit promise on its official pages, so treat third-party claims about “free trial credits” as unverified unless you see them in the MiniMax console. The only entries MiniMax’s official pay-as-you-go pricing lists as Free are the music models Music-3.0-free (and the legacy Music-2.6-free), rate-limited to 3 RPM. Music generation is the one thing you can call at $0 — see the music generation guide for the endpoint. Dated warning: that same guide announces the free music APIs (Music-3.0-free, Music-2.6-free, music-cover-free) will be discontinued from August 20, 2026, and the paid Music and Lyrics APIs will stop onboarding new users the same date — re-check the endpoint’s status before building on it. For text, image, video, and speech, you pay per call.

What “free” means on MiniMax: four routes, one honest answer

Every “free MiniMax API” claim you will find collapses into one of four routes, and they have very different trust profiles:

Route	What you actually get	Cost	Risk
Official key + free endpoints	A real key; Music-3.0-free / Music-2.6-free at 3 RPM	$0	Low — it’s MiniMax’s own docs
Official key, paid models	All models (M3, image-01, H3, Hailuo, speech)	Pay-as-you-go from your balance	Low
Third-party free variants	:free LLM routes on OpenRouter, user-pays SDKs like Puter.js	$0 for you, or your users pay	Medium — limits, availability, ToS
Leaked keys & “generators”	Someone else’s key, or nothing at all	$0 or your account security	High — revocation, abuse, scams

Which route is right depends entirely on which model you need. If you want the M-series coding models, the third-party :free routes in the table below are real but constrained. If you want image or video generation, there is no free route anywhere — official or third-party — and the only question is which paid route to use. Our what is actually free on MiniMax guide goes deeper on the free-versus-paid boundary if you want the full inventory.

Illustrative diagram of the four “free” routes this guide compares, including the red-line route nobody should use.

Getting your MiniMax API key: registration to first environment variable

The setup is three steps and takes about five minutes:

1. Register at platform.minimax.io (international) or platform.minimax.cn (mainland China). MiniMax is migrating the China platform from the old platform.minimaxi.com domain to platform.minimax.cn — the old address still resolves, but the official docs canonicalize it to the .cn one. The two platforms are separate — a key from one will not authenticate against the other.
2. Create the key: API Keys > Create new secret key, then copy it immediately. MiniMax shows it once. Pay-as-you-go uses this key; the Token Plan uses a separate Subscription Key prefixed sk-cp.
3. Store it and set the base URL. MiniMax’s docs recommend exporting it as an environment variable; the API is OpenAI- and Anthropic-compatible, so you can reuse familiar variable names:

export OPENAI_API_KEY="YOUR_MINIMAX_API_KEY"      # OpenAI-compatible
export OPENAI_BASE_URL="https://api.minimax.io/v1"

export ANTHROPIC_API_KEY="YOUR_MINIMAX_API_KEY"   # Anthropic-compatible
export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic"

The international base URL is https://api.minimax.io/v1; China-platform accounts use https://api.minimaxi.com/v1 (the API host documented on the current China platform, platform.minimax.cn). A key with a zero balance can be created but will fail with an insufficient-balance error until you top up at Billing > Balance. If you need the full picture on key types, subscription keys, and the Token Plan, our complete MiniMax API key guide walks through it end to end.

What a MiniMax API key actually costs (August 18, 2026)

The figures below were read from the official Pay-as-you-go pricing page today. Unit rates on this page change frequently — the page itself carries “permanent 50% off” labels that are marketing framing, not deadlines — so treat this as a dated snapshot and re-check before budgeting.

LLM (per million tokens)

Model	Input	Output
MiniMax-M3 (≤512k input tokens)	$0.30	$1.20
MiniMax-M3 (>512k input tokens)	$0.60	$2.40
MiniMax-M2.7 / M2.5 / M2.1 / M2	$0.30	$1.20
MiniMax-M2.7-highspeed	$0.60	$2.40

Image and video

Model	Specification	Price
image-01	per image	$0.0035
MiniMax-H3	2K, per second	$0.13 / sec
MiniMax-H3	768P, per second	$0.08 / sec
Hailuo 2.3 Fast (legacy)	768P, 6s video	$0.19 / task
Hailuo 2.3 / Hailuo 02 (legacy)	768P, 6s video	$0.28 / task

Speech and music

Model	Price
speech-2.8-turbo	$60 / M characters
speech-2.8-hd	$100 / M characters
music-3.0-free	Free (3 RPM) — discontinued Aug 20, 2026
music-3.0	$0.15 / up-to-5-min track

The music-3.0-free row comes with a countdown: the official music generation guide announces the free music APIs (Music-3.0-free, Music-2.6-free, music-cover-free) will be discontinued on August 20, 2026, and the paid Music and Lyrics APIs will stop onboarding new users the same date. Treat it as a sunset, not a stable free tier.

Two billing-unit traps hide in this table. First, video is billed per second for H3 but per finished task for the Hailuo models — convert before comparing. Second, H3 charges extra for input materials beyond five images ($0.04 per additional image) and bills input video by duration. The Token Plan is a separate subscription contract (annual plans, shared monthly quota) — a different trade-off for sustained high volume, not a discount on the per-call meter. For the complete price comparison across every MiniMax route, see our MiniMax pricing breakdown.

Illustrative diagram of MiniMax’s three billing units — per image, per second, per token. Unit rates were read from the official pricing page on August 18, 2026.

First calls with a free key: chat, image, and the free music endpoint

A chat completion with the OpenAI SDK — swap base URL and key, nothing else:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MINIMAX_API_KEY",
    base_url="https://api.minimax.io/v1",
)

resp = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[{"role": "user", "content": "Explain MiniMax rate limits in one sentence."}],
)
print(resp.choices[0].message.content)

Image generation uses a dedicated endpoint:

curl https://api.minimax.io/v1/image_generation \
  -H "Authorization: Bearer YOUR_MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "A glass cube on a dark amber surface, studio lighting",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'

And the one genuinely free call — music generation at 3 RPM:

curl https://api.minimax.io/v1/music_generation \
  -H "Authorization: Bearer YOUR_MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "music-3.0-free",
    "prompt": "a calm ambient pad with slow piano",
    "duration": 30
  }'

Illustrative code-panel artwork for the requests in this section; the endpoints shown are from the official API reference.

When a call fails, MiniMax returns errors as base_resp.status_code in the response body. The official error code reference is the source for the full list; these are the ones new integrations hit:

Code	Message	What to do
2049	invalid API Key	Key string malformed or mistyped. Regenerate and paste clean — no trailing spaces or newlines.
1004	not authorized	Wrong key, revoked key, or wrong platform (international vs China).
1008	insufficient balance	Balance is empty. Top up at Billing > Balance and retry.
1002	rate limit	Exceeding your tier’s RPM. Add exponential backoff.

Free MiniMax routes via third-party gateways: OpenRouter and Puter.js

Two third-party paths genuinely let you call MiniMax models without paying MiniMax. Both are real; both come with asterisks.

OpenRouter’s :free variants — MiniMax M2.5:free is a free-rate-limited variant of the M2.5 model (205K context) served through OpenRouter’s infrastructure. The asterisks: it covers LLM text models only — no image, video, or speech; free variants get deprioritized and can be temporarily unavailable; and availability is OpenRouter’s commercial decision, not MiniMax’s. Fine for prototyping an agent loop, wrong for anything with a latency or uptime requirement.

Puter.js — the Free, Unlimited MiniMax API tutorial describes a different model: Puter.js is a client-side SDK using a user-pays arrangement, where each end user of your app covers their own AI usage through their Puter account. “Free” here means free for you as the developer — not free for your users, and not free at the API level. It is not an official MiniMax API key, it is not server-side, and it should not be the transport for a production backend.

Neither route changes the core fact: for MiniMax’s media models — image-01, H3, Hailuo — there is no free tier anywhere, and the choice is between official pay-as-you-go and a paid aggregator.

The “free MiniMax API key” traps: leaked keys, generators, and lookalike sites

The most dangerous “free” answer on this SERP is the one that looks most generous: a Reddit post where someone pasted their real MiniMax subscription key “for people to use for free.” Do not use it. A shared key can be revoked or rotated by its owner at any moment, your usage burns their balance (or runs into their rate limits), you have zero visibility into what else the key is doing, and you are attaching your production traffic to an account you do not control. The top comment on that thread is “Is this a trap?” — that is the correct read.

Two more traps travel with this keyword:

• “API key generators” don’t exist. MiniMax has no bulk key tool, no key generator, and no third-party distributor of official keys. Any site offering to generate MiniMax API keys is not official and should never receive your credentials.
• Lookalike domains. The SERP for “minimax api key free” includes sites with MiniMax-shaped domains that are not MiniMax. Check the domain against the official platform (platform.minimax.io / platform.minimax.cn — the current China console, successor to platform.minimaxi.com) before entering anything.

The safe path is the boring one: create your own key in the official console, even if you only ever call the free music endpoints with it. A key you created costs the same $0 and keeps your account, your traffic, and your credentials yours.

When one key for many models makes sense: the aggregator route

If your project needs MiniMax and other providers — Hailuo for video, plus Kling, Vidu, Google, or Alibaba routes for the same job — a single aggregator key removes the multi-vendor plumbing. Modellix, the service we run, exposes MiniMax’s media models plus 200+ other image and video models behind one REST API key and one bill, pay-as-you-go, with per-call cost logging. That is the MiniMax provider page listing the exact routes, and our pricing page for how billing units work.

We have a commercial interest in that sentence, so the honest comparison: on the rates we read today, MiniMax’s own image-01 is $0.0035 per image while our matching minimax/minimax-image-01-t2i route lists at $0.0040 — the direct route is cheaper on that specific unit. For video the units diverge: MiniMax lists Hailuo 2.3 at $0.28 per 768P task, while our hailuo-2.3-t2v route lists $0.0386 per second at 768P — convert before comparing, because the billing units are not the same. An aggregator key is a workflow decision, not a price claim. It earns its keep when the alternative is juggling five vendor consoles, five keys, and five invoices — not when you need the absolute lowest unit price on a single model.

Get a Modellix API Key Compare Live Pricing

FAQ

Can I get a MiniMax API key for free?
Yes. Creating a key in the official console is free and no card is documented as required to create it. The cost starts when you call paid models — the API draws from your balance, so a key with $0 balance can only reach the free music endpoints.

Is there a MiniMax free tier?
No universal one. The official pricing page lists only the music models (Music-3.0-free, legacy Music-2.6-free) as Free, at 3 RPM — but the official music guide announces these free music APIs will be discontinued on August 20, 2026 (the paid Music and Lyrics APIs stop onboarding new users the same date). Text, image, video, and speech are all pay-as-you-go. Third-party claims about signup credits are unverified on the official pages.

Do I need a credit card to get a MiniMax API key?
The official quick start does not document a card requirement to create the key. Pay-as-you-go usage bills against your account balance, so you top up when you want to call paid models.

Is there a MiniMax API key generator?
No. MiniMax does not offer key generators or bulk key tools; keys are created one at a time in the console. Sites claiming to generate MiniMax API keys are not official and should not receive your credentials.

Are shared or leaked MiniMax API keys safe to use?
No. The owner can revoke or rotate them at any time, usage burns the owner’s balance, and you have no control over the account. Create your own key — it costs the same and keeps you out of someone else’s billing dispute.

Can I use one MiniMax API key for image and video?
Yes. The same secret key authenticates the LLM, image-01, H3/Hailuo video, speech, and music endpoints under the same base URL. Key type and billing route are the decisions that matter, not the key itself.

How much does using a MiniMax API key cost?
As of August 18, 2026: $0.0035 per image-01 image, $0.30 per M input tokens for MiniMax-M3 (≤512k), $0.08–$0.13 per second for H3 video, and free for the music-3.0-free endpoint. Rates drift — check the official pricing page before budgeting.

Do MiniMax API keys expire?
MiniMax does not publish a fixed expiry for active secret keys. Keys stop working when revoked or invalid (error codes 1004/2049) — check balance, platform, and key string in that order.

---

Prices and endpoints were read from the official MiniMax pages (quickstart-preparation, pricing-paygo, errorcode, music-generation), the OpenRouter and Puter.js pages, and Modellix’s provider and pricing pages on August 18, 2026. MiniMax, third-party gateways, and Modellix can change pricing, models, and terms without notice; this guide is a dated snapshot, not a quote. Modellix is an aggregator and has a commercial interest in the comparison above.

The cover and diagrams are illustrative Modellix artwork; prices in the body were verified against the live official pages on the date above.