ai_sdk_google 3.0.0

Google Generative AI provider for the AI SDK Dart port.

ai_sdk_google

Google Generative AI provider for AI SDK Dart. Supports Gemini language models and text embeddings.

Installation

dependencies:
  ai_sdk_dart: ^3.0.0
  ai_sdk_google: ^3.0.0

Usage

The top-level google factory reads const String.fromEnvironment('GOOGLE_API_KEY'). Use it with fvm dart run --define=GOOGLE_API_KEY=AIza... bin/app.dart, or read Platform.environment['GOOGLE_API_KEY'] yourself and pass apiKey: to GoogleGenerativeAIProvider in server and CLI apps.

Language model

import 'package:ai_sdk_dart/ai_sdk_dart.dart';
import 'package:ai_sdk_google/ai_sdk_google.dart';

final result = await generateText(
  model: google('gemini-2.0-flash'),
  prompt: 'What is the speed of light?',
);
print(result.text);

Streaming

import 'dart:io';

final result = await streamText(
  model: google('gemini-2.0-flash'),
  prompt: 'Tell me about the history of the internet.',
);
await for (final chunk in result.textStream) {
  stdout.write(chunk);
}

Reasoning

The core reasoning: parameter (LanguageModelV4Reasoning, from package:ai_sdk_provider) is mapped internally to Gemini's thinkingConfig/thinkingBudget:

import 'package:ai_sdk_provider/ai_sdk_provider.dart';

final result = await generateText(
  model: google('gemini-2.5-pro'),
  reasoning: LanguageModelV4Reasoning.high,
  prompt: 'Solve step by step: if 3x + 5 = 20, what is x?',
);
print(result.reasoningText);

Gemini's reasoning parts carry an opaque thoughtSignature in providerOptions['google']. Don't read or construct it yourself — reuse result.responseMessages.map(ModelMessage.fromProvider) as history in a follow-up call and it round-trips automatically.

Embeddings

final result = await embed(
  model: google.embedding('text-embedding-004'),
  value: 'Hello, world!',
);
print(result.embedding); // List<double>

Custom API key

final myGoogle = GoogleGenerativeAIProvider(apiKey: 'AIza...');
final result = await generateText(
  model: myGoogle('gemini-2.0-flash'),
  prompt: 'Hello!',
);

License

MIT