{
  "schema_version": 1,
  "public_model_id": "google/gemini-2.5-pro",
  "canonical_page": "https://www.maxapi.dev/models/google/gemini-2.5-pro",
  "reviewed_at": "2026-09-10",
  "generated_at": "2026-09-16T09:38:51.951Z",
  "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 Pro is listed as google/gemini-2.5-pro. 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-pro",
    "reviewed_at": "2026-09-10",
    "title": "Long-context analysis and difficult reasoning",
    "provider_positioning": "Google emphasizes code, mathematics and STEM reasoning for Gemini 2.5 Pro, plus analysis of large documents and codebases. Its official input limit is 1,048,576 tokens; a 200K pricing threshold is not the context-window limit.",
    "selection_advice": "Compare it when the answer depends on relationships across several supplied sources or a difficult technical diagnosis. A narrow tagging task is a better place to first evaluate Lite or Flash.",
    "limitations": "An official long-context capacity is not a promise that every MaxAPI route accepts that full payload. Long input also increases cost and can hide relevant evidence; test retrieval accuracy, not just request acceptance.",
    "suggested_use_cases": [
      {
        "title": "Cross-document contradictions",
        "body": "Label every source and ask for conflicting statements with their locations and unresolved assumptions."
      },
      {
        "title": "Codebase diagnosis",
        "body": "Supply the failing behavior, relevant code and logs. Request a testable hypothesis rather than a confident unverified fix."
      },
      {
        "title": "Technical reasoning review",
        "body": "Ask for conclusions with concise justification and independently check calculations and boundary cases."
      }
    ],
    "example_prompt": {
      "title": "Compare two technical specifications",
      "text": "Compare specification A and specification B. Return a table of incompatible requirements, the exact section identifiers supporting each finding, and a concise explanation of the impact. Separate confirmed contradictions from missing information. Do not invent a reconciliation or cite a section that was not provided. A: [insert]. B: [insert].",
      "review": "Resolve every section reference and spot-check omitted contradictions with a human reviewer."
    },
    "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-pro",
        "url": "https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro"
      }
    ]
  },
  "illustration": {
    "url": "https://www.maxapi.dev/model-guides/individual-20260910/gemini-2-5-pro.webp",
    "alt": "Two engineering binders, tracing overlays and precision ruler on a study table",
    "caption": "Long-document analysis concept: compare constraints and trace disagreements back to their sources.",
    "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-pro.webp",
      "alt": "Two engineering binders, tracing overlays and precision ruler on a study table",
      "caption": "Long-document analysis concept: compare constraints and trace disagreements back to their sources.",
      "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-pro-practice.webp",
      "alt": "Engineering book and mechanical drawing under a magnifying glass",
      "caption": "Examine the specific evidence that supports a technical conclusion.",
      "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-pro-prompt.webp",
      "alt": "Two technical drawings compared with a transparent overlay and metal ruler.",
      "caption": "Physical specification-comparison concept.",
      "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-pro-workflow.webp",
      "alt": "Transparent overlay aligned with specification drawings and a caliper.",
      "caption": "Trace conclusions to sources and check the assumptions.",
      "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-pro",
      "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-pro"
  }
}