gemini

type Config struct {
	// APIKey 是 Google AI Studio API 密钥(从 aistudio.google.com 获取).
	// Vertex AI 模式下此字段被忽略.
	APIKey string

	// BearerToken 是 Vertex AI 的 GCP OAuth2 Bearer token.
	// 非空时切换为 Vertex AI 模式,APIKey 不再使用.
	// 生产环境建议用 google.golang.org/api/oauth2 自动刷新 token,
	// 但引擎核心不引入外部依赖,由调用方在外部刷新后注入.
	BearerToken string

	// BaseURL 覆盖 API 端点.
	// Google AI 默认:https://generativelanguage.googleapis.com
	// Vertex AI 示例:https://us-central1-aiplatform.googleapis.com/v1/projects/my-project/locations/us-central1/publishers/google
	BaseURL string

	// ThinkingBudget 启用扩展思考(Gemini 2.5+,-exp 标签模型).
	// 0 = 禁用;建议值 1024–16384.
	// 通过 generationConfig.thinkingConfig.thinkingBudget 传递.
	ThinkingBudget int

	// HTTPClient 注入自定义 HTTP 客户端(代理,超时等).
	// nil = 使用默认 http.Client (带 Timeout 字段配置的 ResponseHeaderTimeout).
	// 非 nil 时 consumer 完全接管超时责任, 下面的 Timeout 字段被忽略.
	HTTPClient *http.Client

	// Timeout 限制"从请求发出到收到响应首字节"的时间.
	//
	// 通过 http.Transport.ResponseHeaderTimeout 实现, **不影响** SSE 流式响应的后续
	// body 读取 - 长流式回复 (2-5 分钟) 可以正常读完.
	//
	// 精妙之处(CLEVER): 不要误用 http.Client.Timeout - 那会把 SSE 流砍死.
	// 详见 internal/wire/gemini.go 和 anthropic.go §3.1 完整论证.
	//
	// 0 = 使用 defaultTimeout (60s, 适合 Gemini 云端 AI Studio / Vertex AI).
	// 仅当 HTTPClient 为 nil 时生效; 提供自定义 HTTPClient 时此字段被忽略.
	Timeout time.Duration

	// ModelOverrides 覆盖静态模型表.
	// 用于 Google 新发布但我们尚未维护的模型.
	ModelOverrides []flyto.ModelInfo
}

type Provider struct {
	// contains filtered or unexported fields
}