Models and tools
Google Gemini
A Google Gemini integration stores a project-owned Google AI API key. Agents can use that key when they run Gemini models.
Use Gemini when agents should use your Google AI account and quota. When media services are enabled, the same provider can also own built-in image and video actions.
For the shared Google credential model, see Google integrations.
Capability map
| Capability | Value |
|---|---|
| Provider ID | gemini |
| Auth kind | api_key |
| Connect flow | Inline API key |
| Actions | Deployment-dependent |
| Events | No |
| Webhook delivery | No |
| Event samples | No |
| Live status | No |
Connect Google Gemini
| Surface | Support |
|---|---|
| App | Open Govern > Integrations, choose Google Gemini, and paste a Google AI API key. |
| CLI | The mobius CLI does not connect Gemini integrations yet. Use the app or API. |
| API | Call POST /v1/projects/{project}/integrations/providers/gemini/connect with api_key. |
A project-owned key takes precedence over the platform credential for Gemini models. Media actions may use Mobius-managed Google credentials when the catalog marks them ready through the platform source.
Credentials and quota
Create the key in Google AI Studio or your Google AI project, then connect it in Mobius. The key is stored for the project and used when agents select Gemini models.
Treat the key like a production secret. Restrict, rotate, and monitor it from Google when possible. If the integration page says the project is using Mobius built-in credentials, Gemini usage counts against Mobius plan credits instead of your Google AI quota.
Actions
Gemini model credentials alone do not add action catalog entries. When media generation is enabled, these actions can appear:
gemini.edit_image
gemini.generate_image
gemini.generate_videoGenerated media is persisted as an artifact. Video generation is long-running, so expect the action step to stay active for several minutes.
Troubleshooting
Agents do not use the project Gemini key
Check that the agent is configured to use a Gemini model and that the Google Gemini integration page shows a project-owned key. Model routing can still fall back to the platform key when no project key is connected.
Media actions do not appear
Gemini media actions are deployment-dependent. Open Library > Actions to
confirm whether gemini.generate_image, gemini.edit_image, or
gemini.generate_video is registered in the current project.
Video generation looks slow
Video actions can run for several minutes. Watch the run timeline rather than retrying the step, because a retry can create another generation request.
Events
Google Gemini does not register source events.
Next
- Choose agent models from agents.
- Inspect generated media as artifacts.
- Track usage limits with guardrails.