{
  "schema_version": 1,
  "public_model_id": "google/gemini-2.5-flash",
  "canonical_page": "https://www.maxapi.dev/models/google/gemini-2.5-flash",
  "reviewed_at": "2026-09-10",
  "generated_at": "2026-09-11T02:12:59.279Z",
  "scope": "Checked against MaxAPI's public catalogue, gateway implementation and local regression cases. Shared gateway checks are not separate end-to-end tests of every listed model. This is an integration reference, not a live upstream availability or performance report.",
  "summary": "Gemini 2.5 Flash is listed as google/gemini-2.5-flash. Use the Gemini-native request format in the example below, then read candidates and usageMetadata from the response. Model access, routing and account limits are separate from the task instructions you put in contents.",
  "model_profile": {
    "family_id": "google/gemini-2.5-flash",
    "reviewed_at": "2026-09-10",
    "title": "A reasoning-capable general-purpose workhorse",
    "provider_positioning": "Google positions Gemini 2.5 Flash for high-volume, low-latency tasks that still need reasoning. It produces text and supports thinking; it is distinct from Gemini 2.5 Flash Image, which is an image-generation model.",
    "selection_advice": "Compare it between Lite-style field extraction and Pro-style difficult analysis. A useful test combines a short summary, evidence selection and a constrained answer rather than only simple classification.",
    "limitations": "Reasoning can affect token use and latency. Measure both on your chosen route. This text entry does not produce images, speech or a Live API session just because the Gemini family includes those products.",
    "suggested_use_cases": [
      {
        "title": "Evidence-based support drafts",
        "body": "Provide the policy and ticket together. Require a cited policy clause and a short answer, with unresolved cases flagged."
      },
      {
        "title": "Mixed-purpose document summaries",
        "body": "Ask for decisions, reasons and missing facts separately so a plausible summary cannot hide gaps."
      },
      {
        "title": "Moderate-complexity transformations",
        "body": "Transform a supplied specification into a checklist while retaining exceptions and conditions."
      }
    ],
    "example_prompt": {
      "title": "Answer a ticket using policy evidence",
      "text": "Using only the supplied policy and ticket, return: applicable_clause, proposed_reply and missing_information. Quote the relevant clause briefly, keep the reply under 100 words, and mark unsupported requests for human review. Do not invent an exception or authorize a refund. Policy: [insert policy]. Ticket: [insert ticket].",
      "review": "Validate the clause and policy compliance, not just answer fluency."
    },
    "scope": "Provider capabilities describe the model, not the complete MaxAPI feature set. Use the parameters, input types and routes documented for this MaxAPI entry. Vendor speed or quality descriptions are not service-level guarantees.",
    "variant_note": null,
    "sources": [
      {
        "label": "Google · gemini-2.5-flash",
        "url": "https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash"
      }
    ]
  },
  "illustration": {
    "url": "https://www.maxapi.dev/model-guides/individual-20260910/gemini-2-5-flash.webp",
    "alt": "Customer-support headset beside an open handbook and organized note cards",
    "caption": "Grounded support work: consult supplied policy material before drafting a reply.",
    "provenance": "ai_generated_editorial_concept",
    "is_output_from_named_model": false,
    "is_benchmark": false
  },
  "illustrations": [
    {
      "section": "usecases",
      "url": "https://www.maxapi.dev/model-guides/individual-20260910/gemini-2-5-flash.webp",
      "alt": "Customer-support headset beside an open handbook and organized note cards",
      "caption": "Grounded support work: consult supplied policy material before drafting a reply.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "features",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/gemini-2-5-flash-practice.webp",
      "alt": "Open handbook, blue bookmark and blank reply card",
      "caption": "Identify the relevant source passage before drafting a response.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "prompts",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/gemini-2-5-flash-prompt.webp",
      "alt": "Policy booklet under a blue reading guide beside blank stationery and a headset.",
      "caption": "Physical evidence scene for consulting a policy before drafting a reply.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "workflow",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/gemini-2-5-flash-workflow.webp",
      "alt": "A reviewer compares a reply proof with a tabbed policy handbook.",
      "caption": "A person checks the proposed reply against source policy.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    }
  ],
  "configured_facts": [
    {
      "label": "Request model ID",
      "value": "google/gemini-2.5-flash",
      "code": true
    },
    {
      "label": "Output type",
      "value": "Language"
    },
    {
      "label": "Base URL",
      "value": "https://api.maxapi.dev",
      "code": true
    },
    {
      "label": "Generation workflow",
      "value": "Gemini-compatible generateContent"
    }
  ],
  "pricing_scope": "1 credit = US$1. These are catalogue base rates, not a live account quote. Account multipliers and the active billing configuration determine the final charge. Token rates are not a fixed price per image.",
  "pricing_index": "https://www.maxapi.dev/pricing.json",
  "routing_rules": [
    {
      "title": "Which route wins?",
      "body": "Routing priority is: the API key's configured route_modes list → an explicitly requested route → the model's default route. A non-empty key list takes precedence over route_mode in the request. To test a specific route, check the key configuration first; changing the request alone may not change the route used."
    },
    {
      "title": "A key cannot grant account permissions",
      "body": "The a, x and pro routes require the corresponding account permission. Listing one on an API key does not grant that permission. An unauthorized gated-route selection returns 403 rather than silently switching to a different pricing tier."
    },
    {
      "title": "RPM is shared at account level",
      "body": "An account's positive RPM limit covers its API keys together. A key can impose a stricter limit, but a higher key limit does not override the user limit. For example, a user limit of 200 RPM is not 200 RPM for each key. Service-level RPM and concurrency controls also apply; adding keys is not a way to bypass them."
    }
  ],
  "troubleshooting": [
    {
      "code": "403",
      "title": "a_route_not_enabled / x_route_not_enabled / pro_route_not_enabled",
      "meaning": "The selected restricted route is not enabled for the account. It is an access issue, not evidence that the model is offline.",
      "action": "Check both the account permission and the API key's route list. Select a route you are entitled to use or request access; do not solve a 403 by increasing retries."
    },
    {
      "code": "429",
      "title": "rate_limit_exceeded / capacity_exhausted",
      "meaning": "429 can represent account/key RPM, service-wide capacity or generation capacity. Use Retry-After and available X-RateLimit-* / X-Global-* headers to distinguish them; one status code does not identify one unique cause.",
      "action": "Respect Retry-After when present, reduce request rate or active concurrency as appropriate, and use bounded backoff. Do not treat the site's total capacity as your account's personal quota."
    }
  ],
  "verification": {
    "environment": "local_mock_requests_and_test_storage",
    "coverage": "shared_gateway_components_not_each_model_end_to_end",
    "paid_upstream_calls": 0,
    "reviewed_at": "2026-09-10",
    "cases": [
      {
        "key": "shared-user-rpm",
        "title": "Multiple keys share the user limit",
        "input": "Use two keys owned by the same account against an in-memory limiter with a small user quota.",
        "result": "Requests across the keys consume the same user quota; subsequent requests are limited. A larger key quota does not override the user quota, and a smaller key quota remains effective."
      }
    ],
    "limitations": "Local tests use simulated requests, responses and test storage; they do not call paid model channels. They verify request handling, not model image quality, live success rates, latency or end-to-end support for the maximum reference count. The concept illustrations elsewhere on this page are not these test outputs."
  },
  "sources": {
    "maxapi_documentation": "https://www.maxapi.dev/docs",
    "catalogue": "https://www.maxapi.dev/models.json",
    "provider_documentation": "https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash"
  }
}