Start with the failed request and its structured error—not with a blanket model swap. A Gemini failure can mean that the model endpoint has shut down, the request is incompatible with the target model, the API version changed, or an SDK upgrade altered behavior. Record the exact model identifier, API version, SDK version, request parameters, error code and HTTP status, and the first failure time before editing code.
Capture the failure before changing code
Save one representative failing request and its complete response, with secrets and personal data removed. Preserve enough detail to compare what worked with what now fails.
- Exact model identifier, including whether it is a stable version,
latestalias, preview, or experimental model. - API surface and version, such as
v1orv1beta. - SDK name and version, request fields and parameters, and any recent deployment or dependency changes.
- HTTP status, structured error code and message, and timestamp of the first failure.
This snapshot helps separate an unavailable endpoint from a payload, API-version, or SDK compatibility problem.
Use the error to identify the failure class
model_not_found with HTTP 404
Google documents model_not_found in the Interactions API as a 404 meaning the specified model was not found. Verify the exact spelling and check the model’s current lifecycle and availability in Google’s Gemini deprecations page and model catalog. A shutdown turns the endpoint off; the deprecations page lists schedules and recommended replacements. If the model is no longer available, select a currently supported model that meets the app’s requirements. Google’s documented recommendation to verify the name or use another model is not a reason to swap models without checking compatibility.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
HTTP 400 or another request error
Do not interpret every 400 as a shutdown. Google distinguishes invalid_request (HTTP 400) from model_not_found (HTTP 404): the former indicates a malformed payload or invalid parameters. Compare the failing request with the current documentation for the target model and API, paying attention to fields and parameter values. The Gemini API errors reference describes documented codes and actions.
Failures that do not fit those cases
Keep the original status and structured response while checking recent model, API, and SDK changes. A change in one layer can coincide with another, so test each separately rather than treating the model name as the only variable.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Check what kind of model identifier the app uses
Google says stable model identifiers refer to specific versions and usually do not change, and recommends that most production apps use a specific stable model. By contrast, latest is a hot-swapped alias that points to new releases; Google says it gives two weeks’ email notice for breaking changes to the version behind that alias. Preview models may have more restrictive limits and are deprecated with at least two weeks’ notice. Experimental endpoint availability can change.
These categories carry different change risks. If production code uses an alias, preview, or experimental model, check its lifecycle and the date of any change before concluding that a stable model endpoint has been retired. A specific stable identifier can reduce unexpected version changes when it meets the workload’s needs, but it does not remove the need to monitor lifecycle notices.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
Check the API version independently
A model identifier and API version are separate compatibility checks. Google describes v1 as stable, while v1beta exposes early features that may change while under development. An app that depends on a beta feature can therefore encounter compatibility changes independently of a model shutdown. Review the API version in the request and the feature dependencies against Google’s API versions explanation.
Apply migration instructions for the exact source and target
Migration changes are model- and API-specific. For example, Google’s instructions for moving from gemini-3-flash-preview to gemini-3.5-flash list the following changes. This checklist is not a universal recipe for other migrations.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
- Change the model name to
gemini-3.5-flash. - Review pricing for the target model rather than assuming the old model’s cost carries over.
- Remove
temperature,top_p, andtop_kfrom configuration because they are no longer recommended for this target. - Replace
thinking_budgetwiththinking_level. - Add matching
idandnametoFunctionResponseparts. - Use
google-genaiSDK version 2.0.0 or later for this documented migration, while accounting for its breaking changes to the Interactions API.
Google’s migration guide, What’s new in Gemini 3.5 Flash, is the source for those target-specific steps. For a different source model, destination model, or API surface, consult that migration’s own instructions instead of copying these field changes.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Compare replacement models against the workload
Choose a replacement by evaluating more than its name or general capability. Check these dimensions before changing production traffic:
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
- Lifecycle: Is the candidate currently available, and what lifecycle or shutdown schedule applies?
- Capabilities and inputs: Does it support the app’s required inputs, outputs, and tools or function calls?
- Request compatibility: Which API surface, version, fields, and SDK behavior does the candidate require?
- Cost and latency: Measure or review these for the actual workload, and check current pricing rather than relying on stale figures.
Google’s lifecycle page and model catalog help establish availability and model details; its migration guidance also calls out reviewing pricing. A replacement that fixes a 404 can still require request changes or behave differently for the application.
Validate the change before rollout
After applying the relevant migration, test representative application cases in a controlled environment. Compare the old and new behavior where possible, and verify:
- Input and output shapes expected by the application.
- Tool or function-call behavior, including response handling.
- Safety behavior and the app’s handling of refusals or other nonstandard outputs.
- Latency and cost for representative requests.
- Error handling, retries, timeouts, and any fallback path.
These are engineering checks for your application, not guarantees that Google has tested its particular workload. Roll out cautiously and retain a way to revert application-side changes if validation reveals a regression.
Check release notes against the incident date
When the first failure coincides with a documented change, use the date to narrow the investigation. Google’s release notes say that on May 6, 2026, it announced an Interactions API request/response schema change from outputs to steps; the new schema became the default May 26, and the legacy schema was removed June 8. Those dates matter when diagnosing incidents in that timeframe, especially if the app parses Interactions API responses.
Google’s June 1, 2026 release notes state that Gemini 2.0 Flash and Flash-Lite endpoints had shut down and point users to Gemini 3.5 Flash or Gemini 3.1 Flash-Lite. Treat those as dated release-note guidance, not proof that a suggested endpoint remains available indefinitely; verify present availability before adopting one. For other incident dates, consult the full Gemini API release notes for overlapping model or schema changes.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
