feat(ai-gemini): drop retired media models, add Veo 3.1 Lite by tombeckenham · Pull Request #875 · TanStack/ai

tombeckenham · 2026-07-01T02:55:36Z

🎯 Changes

Removes Gemini media models that are no longer reachable via the Gemini Developer API, and adds the new Veo 3.1 Lite model.

Verified against the live API (GET /v1beta/models/{id}): the following all return 404 NOT_FOUND, while gemini-3.1-flash-image-preview, veo-3.1-generate-preview, and imagen-4.0-* return 200 — so the 404s are real deprecations, not an access issue:

Removed model	Reason
`imagen-3.0-generate-002`	404 — superseded by the Imagen 4 family
`veo-2.0-generate-001`	404 — superseded by Veo 3.1
`veo-3.0-generate-001`	404 — superseded by Veo 3.1
`veo-3.0-fast-generate-001`	404 — superseded by Veo 3.1

Added:veo-3.1-lite-generate-preview (Veo 3.1 Lite) — the lowest-cost Veo 3.1 tier ($0.05/sec, 720p, video + audio), durations 4 | 6 | 8.

Changes:

model-meta.ts: remove the four consts + their GEMINI_IMAGE_MODELS / GEMINI_VIDEO_MODELS entries; add VEO_3_1_LITE_PREVIEW.
video/video-provider-options.ts: drop retired models from GeminiVideoModelDurationByName + GEMINI_VIDEO_DURATIONS; add veo-3.1-lite-generate-preview. (No model has the old Veo-2 5|6|8 set anymore.)
image/image-provider-options.ts: drop imagen-3.0-generate-002 from the per-model image caps.
Update unit tests (swap retired fixtures to veo-3.1-lite-generate-preview / imagen-4.0-generate-001; remove the Veo-2-specific duration tests) and docs.

Migration: if you referenced a removed id, use a current model — imagen-4.0-generate-001, veo-3.1-generate-preview, or veo-3.1-lite-generate-preview.

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

New Features
- Added support for a new Gemini Veo preview model with updated video duration options.
- Expanded image generation support to newer Imagen 4 models.
Bug Fixes
- Removed retired image and video model IDs from the available model lists.
- Updated examples and guidance to use currently supported models.
Documentation
- Refreshed Gemini docs and code examples to match the latest model names and capabilities.

Four media models now return 404 NOT_FOUND from the Gemini Developer API and are removed from the adapter's model lists + type maps: imagen-3.0-generate-002, veo-2.0-generate-001, veo-3.0-generate-001, veo-3.0-fast-generate-001. Add veo-3.1-lite-generate-preview (Veo 3.1 Lite) — the lowest-cost Veo 3.1 tier ($0.05/sec, 720p, video+audio), durations 4|6|8. Update the video duration maps, Imagen image caps, unit tests, and docs accordingly. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

coderabbitai · 2026-07-01T02:56:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cfbb8eb1-7dea-4358-9cf4-f43151678670

📥 Commits

Reviewing files that changed from the base of the PR and between 00505fe and b33acb9.

📒 Files selected for processing (11)

.changeset/gemini-drop-retired-media-models.md
docs/adapters/gemini.md
docs/config.json
docs/media/image-generation.md
docs/media/video-generation.md
packages/ai-gemini/src/adapters/image.ts
packages/ai-gemini/src/image/image-provider-options.ts
packages/ai-gemini/src/model-meta.ts
packages/ai-gemini/src/video/video-provider-options.ts
packages/ai-gemini/tests/image-adapter.test.ts
packages/ai-gemini/tests/video-adapter.test.ts

💤 Files with no reviewable changes (2)

docs/adapters/gemini.md
docs/media/image-generation.md

📝 Walkthrough

Walkthrough

This PR retires legacy Gemini media models (Imagen 3.0, Veo 3.0/2.0 variants) and introduces Imagen 4 image models and a Veo 3.1 Lite video model. Changes span model metadata, provider option duration/cap tables, adapter JSDoc examples, documentation, a changeset, and corresponding test updates.

Changes

Gemini Model Catalog Update

Layer / File(s)	Summary
Model metadata catalog `packages/ai-gemini/src/model-meta.ts`	Removes `IMAGEN_3` and adds `VEO_3_1_LITE_PREVIEW` with pricing; updates `GEMINI_IMAGE_MODELS` and `GEMINI_VIDEO_MODELS` exported arrays accordingly.
Image provider options and docs `packages/ai-gemini/src/image/image-provider-options.ts`, `packages/ai-gemini/src/adapters/image.ts`	Refines the image cap comment and updates the `createGeminiImage` JSDoc example to reference Imagen 4.
Video duration mapping `packages/ai-gemini/src/video/video-provider-options.ts`	Replaces retired Veo duration entries with `veo-3.1-lite-generate-preview` mapped to durations `[4, 6, 8]`.
Image adapter tests `packages/ai-gemini/tests/image-adapter.test.ts`	Updates model instantiations and assertions from Imagen 3.0 to Imagen 4.0 across size, count, and prompt validation tests.
Video adapter tests `packages/ai-gemini/tests/video-adapter.test.ts`	Switches adapter instantiations from Veo 3.0/2.0 to Veo 3.1 Lite across duration, snapDuration, job creation, and error tests.
Docs, config, and changeset `docs/adapters/gemini.md`, `docs/media/image-generation.md`, `docs/media/video-generation.md`, `docs/config.json`, `.changeset/gemini-drop-retired-media-models.md`	Updates model tables/examples to Imagen 4 and Veo 3.1 Lite, refreshes `updatedAt` timestamps, and documents the minor release with migration guidance.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related issues

Support Google Nano Banana 2 Lite image model (gemini-3.1-flash-lite-image) #870: Both touch the Gemini model registry/image metadata, though this PR retires/replaces existing Imagen/Veo IDs rather than adding a new flash-lite image model.

Poem

A hop, a skip, old models retire,
Imagen 4 and Veo Lite catch fire! 🐇
Out with the 3.0, in with the new,
Durations of four, six, eight too.
Docs all updated, tests all pass —
This bunny's release notes are pure class! 🥕

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly matches the main change: removing retired Gemini media models and adding Veo 3.1 Lite.
Description check	✅ Passed	The description follows the template and includes changes, checklist items, release impact, and migration guidance.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch gemini-drop-retired-media-models

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-07-01T02:56:50Z

🚀 Changeset Version Preview

3 package(s) bumped directly, 0 bumped as dependents.

🟨 Minor bumps

Package	Version	Reason
`@tanstack/ai-gemini`	0.18.4 → 0.19.0	Changeset

🟩 Patch bumps

Package	Version	Reason
`@tanstack/ai-anthropic`	0.15.12 → 0.15.13	Changeset
`@tanstack/ai-react`	0.16.1 → 0.16.2	Changeset

nx-cloud · 2026-07-01T02:56:55Z

View your CI Pipeline Execution ↗ for commit b33acb9

Command	Status	Duration	Result
`nx run-many --targets=build --exclude=examples/...`	✅ Succeeded	2s	View ↗

☁️ Nx Cloud last updated this comment at 2026-07-01 02:56:58 UTC

pkg-pr-new · 2026-07-01T02:57:37Z

Open in StackBlitz

@tanstack/ai

npm i https://pkg.pr.new/@tanstack/ai@875

@tanstack/ai-acp

npm i https://pkg.pr.new/@tanstack/ai-acp@875

@tanstack/ai-angular

npm i https://pkg.pr.new/@tanstack/ai-angular@875

@tanstack/ai-anthropic

npm i https://pkg.pr.new/@tanstack/ai-anthropic@875

@tanstack/ai-bedrock

npm i https://pkg.pr.new/@tanstack/ai-bedrock@875

@tanstack/ai-claude-code

npm i https://pkg.pr.new/@tanstack/ai-claude-code@875

@tanstack/ai-client

npm i https://pkg.pr.new/@tanstack/ai-client@875

@tanstack/ai-code-mode

npm i https://pkg.pr.new/@tanstack/ai-code-mode@875

@tanstack/ai-code-mode-skills

npm i https://pkg.pr.new/@tanstack/ai-code-mode-skills@875

@tanstack/ai-codex

npm i https://pkg.pr.new/@tanstack/ai-codex@875

@tanstack/ai-devtools-core

npm i https://pkg.pr.new/@tanstack/ai-devtools-core@875

@tanstack/ai-elevenlabs

npm i https://pkg.pr.new/@tanstack/ai-elevenlabs@875

@tanstack/ai-event-client

npm i https://pkg.pr.new/@tanstack/ai-event-client@875

@tanstack/ai-fal

npm i https://pkg.pr.new/@tanstack/ai-fal@875

@tanstack/ai-gemini

npm i https://pkg.pr.new/@tanstack/ai-gemini@875

@tanstack/ai-grok

npm i https://pkg.pr.new/@tanstack/ai-grok@875

@tanstack/ai-grok-build

npm i https://pkg.pr.new/@tanstack/ai-grok-build@875

@tanstack/ai-groq

npm i https://pkg.pr.new/@tanstack/ai-groq@875

@tanstack/ai-isolate-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-isolate-cloudflare@875

@tanstack/ai-isolate-node

npm i https://pkg.pr.new/@tanstack/ai-isolate-node@875

@tanstack/ai-isolate-quickjs

npm i https://pkg.pr.new/@tanstack/ai-isolate-quickjs@875

@tanstack/ai-mcp

npm i https://pkg.pr.new/@tanstack/ai-mcp@875

@tanstack/ai-mistral

npm i https://pkg.pr.new/@tanstack/ai-mistral@875

@tanstack/ai-ollama

npm i https://pkg.pr.new/@tanstack/ai-ollama@875

@tanstack/ai-openai

npm i https://pkg.pr.new/@tanstack/ai-openai@875

@tanstack/ai-opencode

npm i https://pkg.pr.new/@tanstack/ai-opencode@875

@tanstack/ai-openrouter

npm i https://pkg.pr.new/@tanstack/ai-openrouter@875

@tanstack/ai-preact

npm i https://pkg.pr.new/@tanstack/ai-preact@875

@tanstack/ai-react

npm i https://pkg.pr.new/@tanstack/ai-react@875

@tanstack/ai-react-ui

npm i https://pkg.pr.new/@tanstack/ai-react-ui@875

@tanstack/ai-sandbox

npm i https://pkg.pr.new/@tanstack/ai-sandbox@875

@tanstack/ai-sandbox-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-sandbox-cloudflare@875

@tanstack/ai-sandbox-daytona

npm i https://pkg.pr.new/@tanstack/ai-sandbox-daytona@875

@tanstack/ai-sandbox-docker

npm i https://pkg.pr.new/@tanstack/ai-sandbox-docker@875

@tanstack/ai-sandbox-local-process

npm i https://pkg.pr.new/@tanstack/ai-sandbox-local-process@875

@tanstack/ai-sandbox-vercel

npm i https://pkg.pr.new/@tanstack/ai-sandbox-vercel@875

@tanstack/ai-solid

npm i https://pkg.pr.new/@tanstack/ai-solid@875

@tanstack/ai-solid-ui

npm i https://pkg.pr.new/@tanstack/ai-solid-ui@875

@tanstack/ai-svelte

npm i https://pkg.pr.new/@tanstack/ai-svelte@875

@tanstack/ai-utils

npm i https://pkg.pr.new/@tanstack/ai-utils@875

@tanstack/ai-vue

npm i https://pkg.pr.new/@tanstack/ai-vue@875

@tanstack/ai-vue-ui

npm i https://pkg.pr.new/@tanstack/ai-vue-ui@875

@tanstack/openai-base

npm i https://pkg.pr.new/@tanstack/openai-base@875

@tanstack/preact-ai-devtools

npm i https://pkg.pr.new/@tanstack/preact-ai-devtools@875

@tanstack/react-ai-devtools

npm i https://pkg.pr.new/@tanstack/react-ai-devtools@875

@tanstack/solid-ai-devtools

npm i https://pkg.pr.new/@tanstack/solid-ai-devtools@875

commit: b33acb9

tombeckenham requested a review from a teamJuly 1, 2026 03:10

AlemTuzlak approved these changes Jul 1, 2026
View reviewed changes

AlemTuzlak merged commit f0c12ba into mainJul 1, 2026
10 checks passed

AlemTuzlak deleted the gemini-drop-retired-media-models branch July 1, 2026 09:04

github-actionsBot mentioned this pull request Jul 1, 2026
ci: Version Packages #873
Merged

coderabbitaiBot mentioned this pull request Jul 7, 2026
feat(ai-gemini): Gemini Omni Flash video generation via the Interactions API #886
Merged

Navigation Menu

Uh oh!

Uh oh!

feat(ai-gemini): drop retired media models, add Veo 3.1 Lite - #875

feat(ai-gemini): drop retired media models, add Veo 3.1 Lite#875
AlemTuzlak merged 1 commit into
mainfrom
gemini-drop-retired-media-models

tombeckenham commented Jul 1, 2026•
edited by coderabbitai Bot
Loading

Uh oh!

coderabbitaiBot commented Jul 1, 2026•
edited
Loading

Walkthrough

Changes

Uh oh!

github-actionsBot commented Jul 1, 2026

Uh oh!

nx-cloudBot commented Jul 1, 2026•
edited
Loading

Uh oh!

pkg-pr-newBot commented Jul 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

tombeckenham commented Jul 1, 2026• edited by coderabbitai BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

coderabbitaiBot commented Jul 1, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

github-actionsBot commented Jul 1, 2026

🚀 Changeset Version Preview

🟨 Minor bumps

🟩 Patch bumps

Uh oh!

nx-cloudBot commented Jul 1, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-newBot commented Jul 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

tombeckenham commented Jul 1, 2026•
edited by coderabbitai Bot
Loading

coderabbitaiBot commented Jul 1, 2026•
edited
Loading

nx-cloudBot commented Jul 1, 2026•
edited
Loading