feat: add apiKeyHelper and apiKeyRefreshInterval options for dynamic API key management

[gabry-lab]

Closes #1302

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

Potential Duplicate Found:

• PR feat: add apiKeyCommand for dynamic API key retrieval #8198: "feat: add apiKeyCommand for dynamic API key retrieval"
  • feat: add apiKeyCommand for dynamic API key retrieval #8198

Why they might be related: Both PRs address dynamic API key management. PR #8198 adds apiKeyCommand for dynamic API key retrieval, while PR #8817 adds apiKeyHelper and apiKeyRefreshInterval options. These appear to be alternative or overlapping approaches to solving the same problem of managing API keys dynamically. You should review PR #8198 to ensure there's no conflicting implementation or to see if they should be consolidated.

[Haoping-Xiao]

@thdxr please review this PR. this is a super important feature for users using litellm proxy with rotating api key expiratiion

[dottharun]

The getLanguage function which does the getSDK call also caches the model with model.providerId and model.id as key,

so for long running sessions, this will provide stale sdk without calling the apiHelper again

opencode/packages/opencode/src/provider/provider.ts

Lines 1086 to 1089 in c130dd4

	export async function getLanguage(model: Model): Promise<LanguageModelV2> {
	const s = await state()
	const key = `${model.providerID}/${model.id}`
	if (s.models.has(key)) return s.models.get(key)!