Integrations
Google Gemini
A Google Gemini integration stores an organization-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 Library > 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/integrations/providers/gemini/connect with api_key. |
An organization-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 organization 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 your organization 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 stored 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 organization Gemini key
Check that the agent is configured to use a Gemini model and that the Google Gemini integration page shows an organization-owned key. Model routing can still fall back to the platform key when no organization 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 organization.
Video generation looks slow
Video actions can run for several minutes. Watch the turn's activity 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.