# MaxAPI

> Documentation index for MaxAPI authentication, endpoints, public models, provider sources, and route-level pricing.

Canonical website: https://www.maxapi.dev
API base URL: https://api.maxapi.dev
Authentication: Authorization: Bearer $MAXAPI_KEY
Billing: 1 credit = 1 USD; failed generation tasks are not charged.
Catalogue summaries do not enumerate every conditional price tier or minimum charge. Check current account prices for the applicable conditions, billing units and minimum charges before estimating cost.

## Route selection

These are recognized route values, not a promise that every model supports every route. Availability depends on the model, enabled routes and your account. The pro, x and a routes require account permission; requesting one without permission returns 403.
Routing precedence: a configured API key route_modes list takes priority over the request. Otherwise, an explicit request route is used; if neither is set, the model default applies. Check the API key settings before comparing route prices.

## Endpoint families

- OpenAI model discovery: GET /v1/models
- Language: POST /v1beta/models/{model}:generateContent
- Images: POST /v1/images/generations and POST /v1/images/edits
- Videos: POST /v1/videos/generations, followed by task polling
- Gemini media: POST /v1beta/models/{model}:generateContent
- Gemini model discovery: GET /v1beta/models and GET /v1beta/models/{model}
- MaxAPI structured model catalogue: GET https://www.maxapi.dev/models.json
- Account balance (shared by all keys owned by the same account): GET /v1/account/balance
- Per-key historical billing (scoped automatically to the Bearer key): GET /v1/account/billing/usage
- new-api-compatible API-key quota: GET /api/usage/token
- sub2api-compatible API-key balance: GET /v1/usage

## Public models

### Language models

- [Gemini 2.5 Flash](https://www.maxapi.dev/models/google/gemini-2.5-flash): `google/gemini-2.5-flash` — Gemini 2.5 Flash is a fast, low-cost language model for chat and text generation, billed per token on MaxAPI. Pricing: official-cheap: input $0.1235/M, output $1.0294/M, audio_input $0.4118/M, cache_read $0.0124/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-2.5-flash.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash).
- [Gemini 2.5 Flash-Lite](https://www.maxapi.dev/models/google/gemini-2.5-flash-lite): `google/gemini-2.5-flash-lite` — Gemini 2.5 Flash-Lite focuses on lightweight classification and explicit field extraction, billed per token on MaxAPI. Pricing: official-cheap: input $0.0412/M, output $0.1647/M, audio_input $0.1235/M, cache_read $0.0041/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-2.5-flash-lite.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash-lite).
- [Gemini 2.5 Pro](https://www.maxapi.dev/models/google/gemini-2.5-pro): `google/gemini-2.5-pro` — Gemini 2.5 Pro focuses on complex technical reasoning and long-document analysis. Context capacity and pricing thresholds are separate; route limits apply. Pricing: official-cheap: input (≤200k) $0.5147/M, output (≤200k) $4.1176/M, cache_read (≤200k) $0.0515/M, input (>200k) $1.0294/M, output (>200k) $6.1765/M, cache_read (>200k) $0.1029/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-2.5-pro.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro).
- [Gemini 3 Flash Preview](https://www.maxapi.dev/models/google/gemini-3-flash-preview): `google/gemini-3-flash-preview` — Gemini 3 Flash Preview supports interactive reasoning and multimodal understanding with text output. Preview availability and route capabilities should be checked. Pricing: official-cheap: input $0.2059/M, output $1.2353/M, audio_input $0.4118/M, cache_read $0.0206/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3-flash-preview.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3-flash-preview).
- [Gemini 3.1 Flash-Lite](https://www.maxapi.dev/models/google/gemini-3.1-flash-lite): `google/gemini-3.1-flash-lite` — Gemini 3.1 Flash-Lite focuses on high-frequency translation, extraction and lightweight text workflows, billed per token on MaxAPI. Pricing: official-cheap: input $0.1029/M, output $0.6176/M, audio_input $0.2059/M, cache_read $0.0103/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.1-flash-lite.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite).
- [Gemini 3.1 Pro Preview](https://www.maxapi.dev/models/google/gemini-3.1-pro-preview): `google/gemini-3.1-pro-preview` — Gemini 3.1 Pro Preview focuses on complex engineering, reasoning and multi-step planning. MaxAPI route capabilities and input limits apply. Pricing: official-cheap: input (≤200k) $0.8235/M, output (≤200k) $4.9412/M, cache_read (≤200k) $0.0824/M, input (>200k) $1.6471/M, output (>200k) $7.4118/M, cache_read (>200k) $0.1647/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.1-pro-preview.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.1-pro-preview).
- [Gemini 3.5 Flash](https://www.maxapi.dev/models/google/gemini-3.5-flash): `google/gemini-3.5-flash` — Gemini 3.5 Flash is a stable text-model entry for iterative engineering and multi-step workflows. Applications manage execution and validation. Pricing: official-cheap: input $0.6176/M, output $3.7059/M, cache_read $0.0618/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.5-flash.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.5-flash).

### Image models

- [GPT Image 2](https://www.maxapi.dev/models/openai/gpt-image-2): `openai/gpt-image-2` — GPT Image 2 supports image generation and editing with token-based image billing on MaxAPI. Pricing: official: text_input $5/M, image_input $8/M, image_output $30/M; official-cheap: text_input $3/M, image_input $4.8/M, image_output $18/M; mix: $0.019 per output image. [Integration facts](https://www.maxapi.dev/model-guides/facts/openai--gpt-image-2.json). [Provider source](https://developers.openai.com/api/docs/models/gpt-image-2).
- [GPT Image 2.5 Sunburst](https://www.maxapi.dev/models/openai/gpt-image-2.5-sunburst): `openai/gpt-image-2.5-sunburst` — Image generation and editing. Mix: 0.018, X: 0.012, A: 0.009 credits per successful request. Account multipliers apply; A and X require access. Pricing: mix: $0.018 per call; x: $0.012 per call; a: $0.009 per call. [Integration facts](https://www.maxapi.dev/model-guides/facts/openai--gpt-image-2.5-sunburst.json). [Provider source](https://developers.openai.com/api/docs/models/gpt-image-2.5-sunburst).
- [GPT Image 2.5 Flare](https://www.maxapi.dev/models/openai/gpt-image-2.5-flare): `openai/gpt-image-2.5-flare` — Image generation and editing. Mix: 0.018, X: 0.012, A: 0.009 credits per successful request. Account multipliers apply; A and X require access. Pricing: mix: $0.018 per call; x: $0.012 per call; a: $0.009 per call. [Integration facts](https://www.maxapi.dev/model-guides/facts/openai--gpt-image-2.5-flare.json). [Provider source](https://developers.openai.com/api/docs/models/gpt-image-2.5-flare).
- [Gemini 2.5 Flash Image](https://www.maxapi.dev/models/google/gemini-2.5-flash-image): `google/gemini-2.5-flash-image` — Gemini 2.5 Flash Image supports fast fixed-price image generation and reference-based editing on MaxAPI. Pricing: official: $0.04 per call; official-cheap: $0.024 per call. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-2.5-flash-image.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash-image).
- [Gemini 3.1 Flash Lite Image](https://www.maxapi.dev/models/google/gemini-3.1-flash-lite-image): `google/gemini-3.1-flash-lite-image` — Nano Banana 2 Lite focuses on lightweight 1K generation and localized image edits. Check this MaxAPI entry's reference limits and route pricing before use. Pricing: mix: $0.015 per call. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.1-flash-lite-image.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite-image).
- [Nanobanana Pro](https://www.maxapi.dev/models/google/gemini-3-pro-image-preview): `google/gemini-3-pro-image-preview` — Nanobanana Pro supports high quality image generation and reference-based editing on MaxAPI. Pricing: official: input $2/M, output $120/M; official-cheap: input $1.2/M, output $72/M; mix: input $0.37/M, output $22.29/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3-pro-image-preview.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3-pro-image).
- [Gemini 3.1 Flash Image Preview](https://www.maxapi.dev/models/google/gemini-3.1-flash-image-preview): `google/gemini-3.1-flash-image-preview` — Gemini 3.1 Flash Image Preview supports fast high-resolution image generation and reference-based editing on MaxAPI. Pricing: official: input $0.5/M, output $60/M; official-cheap: input $0.3/M, output $36/M; mix: input $0.093/M, output $11.14/M. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.1-flash-image-preview.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-image).
- [Gemini 3 Pro Image Preview Beta](https://www.maxapi.dev/models/google/gemini-3-pro-image-preview-beta): `google/gemini-3-pro-image-preview-beta` — Gemini 3 Pro Image Preview Beta supports 4K image generation and reference-based editing on MaxAPI. Pricing: official-cheap: $0.085 per output image; mix: $0.065 per output image. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3-pro-image-preview-beta.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3-pro-image).
- [Gemini 3.1 Flash Image Preview Beta](https://www.maxapi.dev/models/google/gemini-3.1-flash-image-preview-beta): `google/gemini-3.1-flash-image-preview-beta` — Gemini 3.1 Flash Image Preview Beta supports high-resolution image generation and reference-based editing on MaxAPI. Pricing: official-cheap: $0.07 per output image; mix: $0.045 per output image. [Integration facts](https://www.maxapi.dev/model-guides/facts/google--gemini-3.1-flash-image-preview-beta.json). [Provider source](https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-image).
- [GPT Image 2 Beta](https://www.maxapi.dev/models/openai/gpt-image-2-beta): `openai/gpt-image-2-beta` — GPT Image 2 Beta supports image generation and editing with mix and official-cheap routes. Pricing: official-cheap: text_input $0.35/M, image_input $0.35/M, image_output $0.7/M; mix: $0.019 per output image. [Integration facts](https://www.maxapi.dev/model-guides/facts/openai--gpt-image-2-beta.json). [Provider source](https://developers.openai.com/api/docs/models/gpt-image-2).

### Video models

- [Seedance 2.0 Fast](https://www.maxapi.dev/models/model/seedance-2.0-fast): `model/seedance-2.0-fast` — Seedance 2.0 Fast generates video, billed per output token by resolution and reference mode. Pricing: official-cheap: 480p $0.104/s, 720p $0.104/s; mix: 480p $0.09/s, 720p $0.09/s. [Integration facts](https://www.maxapi.dev/model-guides/facts/model--seedance-2.0-fast.json). [Provider source](https://docs.byteplus.com/en/docs/byteplus_las/video_gen_enhanced).
- [Seedance 2.0](https://www.maxapi.dev/models/model/seedance-2.0): `model/seedance-2.0` — Seedance 2.0 supports up to 1080p, billed per output token by resolution and reference mode. Pricing: official-cheap: 480p $0.127/s, 720p $0.127/s, 1080p $0.127/s; mix: 480p $0.112/s, 720p $0.112/s, 1080p $0.112/s. [Integration facts](https://www.maxapi.dev/model-guides/facts/model--seedance-2.0.json). [Provider source](https://seed.bytedance.com/en/seedance2_0).
- [Seedance 2.5](https://www.maxapi.dev/models/model/seedance-2.5): `model/seedance-2.5` — Seedance 2.5 multimodal video generation at 720p. Supports 4 to 30 second clips, up to 30 reference images, 10 reference videos, and 10 reference audio files. Pricing: mix: 720p $0.09/s. [Integration facts](https://www.maxapi.dev/model-guides/facts/model--seedance-2.5.json). [Provider source](https://seed.bytedance.com/en/seedance2_5).

## Developer guides

Examples are MaxAPI-specific, local-fixture tested, not live model benchmarks. Real API calls can incur charges.
- [Generate an image with Python](https://www.maxapi.dev/guides/image-api-python): Use the Python standard library to submit one MaxAPI image task, poll its status and recover without blindly generating a second image.
- [Generate an image with Node.js](https://www.maxapi.dev/guides/image-api-nodejs): A dependency-free Node.js example with native fetch, bounded polling, explicit failures and no automatic POST retries.
- [Async image tasks: submit once, poll safely](https://www.maxapi.dev/guides/async-image-tasks): Understand HTTP 202, queued and running states, successful results, failed tasks and recovery after a client timeout.
- [Send reference images without avoidable input errors](https://www.maxapi.dev/guides/reference-image-editing): Choose the image edit endpoint, preserve reference order, validate real image files and check model-specific limits before scaling to many inputs.
- [Image resolution, aspect ratio and quality are different controls](https://www.maxapi.dev/guides/image-resolution-and-quality): Avoid copying 4K or high-quality settings between incompatible models. Match output parameters to the chosen MaxAPI model and endpoint.
- [Handle 429 and retries without a request storm](https://www.maxapi.dev/guides/rate-limits-and-retries): Distinguish request rate from concurrency, avoid unbounded retries and keep task polling separate from new generation submissions.
- [Diagnose image API errors before resubmitting](https://www.maxapi.dev/guides/image-api-errors): Separate connectivity, authentication, input, credit, policy and upstream errors; HTTP success alone does not establish task success.
- [Understand routes, prices and available balance](https://www.maxapi.dev/guides/route-pricing-and-balance): Read public prices as a catalogue, confirm account-specific access, and separate a temporary reservation from a settled charge.
- [Choose an image API model by requirements, not its name](https://www.maxapi.dev/guides/choose-an-image-model): Compare five MaxAPI image entries by reference limits, output controls and published routing. Then verify quality and actual cost with the same authorized inputs.
- [Connect MaxAPI images to n8n without duplicate submissions](https://www.maxapi.dev/guides/image-api-n8n): Configure a manual submit workflow and a separate status check with HTTP Request, credential storage and explicit task-state handling.

## Authoritative indexes

- [Documentation](https://www.maxapi.dev/docs)
- [Developer guides](https://www.maxapi.dev/guides)
- [Guide index JSON](https://www.maxapi.dev/guides.json)
- [Models JSON](https://www.maxapi.dev/models.json)
- [Pricing JSON](https://www.maxapi.dev/pricing.json)
- [Pricing page](https://www.maxapi.dev/pricing)
- [Terms](https://www.maxapi.dev/terms)
- [Privacy](https://www.maxapi.dev/privacy)

## Contact

Support: mailto:support@maxapi.dev