@ai-sdk/cerebras 3.0.81 → 3.0.82

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-sdk/cerebras
 
+## 3.0.82
+
+### Patch Changes
+
+- 7716e18: Support promises and synchronous or asynchronous callbacks in provider API key and token settings. Resolve credentials per authenticated request while preserving existing authentication behavior and synchronous credential serialization.
+
+  The experimental OpenAI Live `getServerWebSocketConfig()` method can now resolve asynchronously. Await its result before using the connection settings.
+
+- Updated dependencies [7716e18]
+- Updated dependencies [5c247e9]
+- Updated dependencies [dcd2f8d]
+  - @ai-sdk/openai-compatible@3.0.82
+  - @ai-sdk/provider-utils@5.0.72
+  - @ai-sdk/provider@4.0.35
+
 ## 3.0.81
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { LanguageModelV4, ProviderV4 } from "@ai-sdk/provider";
-import { FetchFunction } from "@ai-sdk/provider-utils";
+import { FetchFunction, Resolvable } from "@ai-sdk/provider-utils";
 import { z } from "zod/v4";
 //#region src/cerebras-chat-options.d.ts
 type CerebrasChatModelId = 'gpt-oss-120b' | 'gemma-4-31b' | (string & {});
@@ -15,8 +15,9 @@ type CerebrasErrorData = z.infer<typeof cerebrasErrorSchema>;
 interface CerebrasProviderSettings {
   /**
    * Cerebras API key.
+   * A function is called before each request and may return a promise.
    */
-  apiKey?: string;
+  apiKey?: Resolvable<string>;
   /**
    * Base URL for the API calls.
    */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cerebras-chat-options.ts","../src/cerebras-provider.ts","../src/cerebras-chat-language-model-options.ts","../src/version.ts"],"mappings":";;;;KACY;;;cCiBN,qBAAmB,EAAA;;;;;GAKvB,EAAA,KAAA;KAEU,oBAAoB,EAAE,aAAa;UAkE9B;;;;EAIf;;;;EAIA;;;;EAIA,UAAU;;;;;EAKV,QAAQ;;UAGO,yBAAyB;;;;GAIvC,SAAS,sBAAsB;;;;EAKhC,cAAc,SAAS,sBAAsB;;;;EAK7C,KAAK,SAAS,sBAAsB;;;;EAKpC,mBAAmB;;wBAGL,eACd,UAAS,2BACR;qBA+CU,UAAQ;;;cClLR,kCAAgC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsB3C,EAAA,KAAA;KAEU,mCAAmC,EAAE,aACxC;;;qBC3BI"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cerebras-chat-options.ts","../src/cerebras-provider.ts","../src/cerebras-chat-language-model-options.ts","../src/version.ts"],"mappings":";;;;KACY;;;cCmBN,qBAAmB,EAAA;;;;;GAKvB,EAAA,KAAA;KAEU,oBAAoB,EAAE,aAAa;UAkE9B;;;;;EAKf,SAAS;;;;EAIT;;;;EAIA,UAAU;;;;;EAKV,QAAQ;;UAGO,yBAAyB;;;;GAIvC,SAAS,sBAAsB;;;;EAKhC,cAAc,SAAS,sBAAsB;;;;EAK7C,KAAK,SAAS,sBAAsB;;;;EAKpC,mBAAmB;;wBAGL,eACd,UAAS,2BACR;qBAiDU,UAAQ;;;cCvLR,kCAAgC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsB3C,EAAA,KAAA;KAEU,mCAAmC,EAAE,aACxC;;;qBC3BI"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { NoSuchModelError } from "@ai-sdk/provider";
-import { WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, loadApiKey, serializeModelOptions, withUserAgentSuffix, withoutTrailingSlash } from "@ai-sdk/provider-utils";
+import { WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, loadApiKey, resolveWith, serializeModelOptions, withUserAgentSuffix, withoutTrailingSlash } from "@ai-sdk/provider-utils";
 import { OpenAICompatibleChatLanguageModel } from "@ai-sdk/openai-compatible";
 import { z } from "zod/v4";
 //#region src/cerebras-chat-language-model.ts
@@ -61,7 +61,7 @@ var CerebrasChatLanguageModel = class CerebrasChatLanguageModel extends OpenAICo
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "3.0.81";
+const VERSION = "3.0.82";
 //#endregion
 //#region src/cerebras-provider.ts
 const cerebrasErrorStructure = {
@@ -100,14 +100,14 @@ function transformCerebrasRequestBody(args) {
 }
 function createCerebras(options = {}) {
 	const baseURL = withoutTrailingSlash(options.baseURL ?? "https://api.cerebras.ai/v1");
-	const getHeaders = () => withUserAgentSuffix({
+	const getHeaders = () => resolveWith(options.apiKey, (apiKey) => withUserAgentSuffix({
 		Authorization: `Bearer ${loadApiKey({
-			apiKey: options.apiKey,
+			apiKey,
 			environmentVariableName: "CEREBRAS_API_KEY",
 			description: "Cerebras API key"
 		})}`,
 		...options.headers
-	}, `ai-sdk-cerebras/${VERSION}`);
+	}, `ai-sdk-cerebras/${VERSION}`));
 	const createLanguageModel = (modelId) => {
 		return new CerebrasChatLanguageModel(modelId, {
 			provider: `cerebras.chat`,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/cerebras-chat-language-model.ts","../src/version.ts","../src/cerebras-provider.ts"],"sourcesContent":["import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';\nimport type {\n  LanguageModelV4,\n  LanguageModelV4CallOptions,\n  LanguageModelV4GenerateResult,\n  LanguageModelV4StreamPart,\n  LanguageModelV4StreamResult,\n} from '@ai-sdk/provider';\nimport {\n  serializeModelOptions,\n  WORKFLOW_DESERIALIZE,\n  WORKFLOW_SERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport type { CerebrasChatModelId } from './cerebras-chat-language-model-options';\n\ntype CerebrasChatConfig = ConstructorParameters<\n  typeof OpenAICompatibleChatLanguageModel\n>[1];\n\nfunction isStructuredOutputWithToolCallsFinishReason({\n  rawFinishReason,\n  hasText,\n  responseFormatType,\n}: {\n  rawFinishReason: string | undefined;\n  hasText: boolean;\n  responseFormatType:\n    | NonNullable<LanguageModelV4CallOptions['responseFormat']>['type']\n    | undefined;\n}) {\n  return (\n    responseFormatType === 'json' && rawFinishReason === 'tool_calls' && hasText\n  );\n}\n\nexport class CerebrasChatLanguageModel\n  extends OpenAICompatibleChatLanguageModel\n  implements LanguageModelV4\n{\n  static [WORKFLOW_SERIALIZE](model: CerebrasChatLanguageModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: CerebrasChatModelId;\n    config: CerebrasChatConfig;\n  }) {\n    return new CerebrasChatLanguageModel(options.modelId, options.config);\n  }\n\n  async doGenerate(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4GenerateResult> {\n    const result = await super.doGenerate(options);\n\n    if (\n      !isStructuredOutputWithToolCallsFinishReason({\n        rawFinishReason: result.finishReason.raw,\n        hasText: result.content.some(\n          part => part.type === 'text' && part.text.length > 0,\n        ),\n        responseFormatType: options.responseFormat?.type,\n      })\n    ) {\n      return result;\n    }\n\n    return {\n      ...result,\n      // Cerebras GLM can return valid structured output text while also\n      // repeating a tool call. Treat that mixed response as the final answer.\n      content: result.content.filter(part => part.type !== 'tool-call'),\n      finishReason: {\n        ...result.finishReason,\n        unified: 'stop',\n      },\n    };\n  }\n\n  async doStream(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4StreamResult> {\n    const result = await super.doStream(options);\n    let hasText = false;\n\n    return {\n      ...result,\n      stream: result.stream.pipeThrough(\n        new TransformStream<\n          LanguageModelV4StreamPart,\n          LanguageModelV4StreamPart\n        >({\n          transform(part, controller) {\n            if (part.type === 'text-delta' && part.delta.length > 0) {\n              hasText = true;\n            }\n\n            if (\n              part.type === 'finish' &&\n              isStructuredOutputWithToolCallsFinishReason({\n                rawFinishReason: part.finishReason.raw,\n                hasText,\n                responseFormatType: options.responseFormat?.type,\n              })\n            ) {\n              controller.enqueue({\n                ...part,\n                finishReason: {\n                  ...part.finishReason,\n                  unified: 'stop',\n                },\n              });\n              return;\n            }\n\n            if (\n              options.responseFormat?.type === 'json' &&\n              hasText &&\n              (part.type === 'tool-input-start' ||\n                part.type === 'tool-input-delta' ||\n                part.type === 'tool-input-end' ||\n                part.type === 'tool-call')\n            ) {\n              return;\n            }\n\n            controller.enqueue(part);\n          },\n        }),\n      ),\n    };\n  }\n}\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';\nimport {\n  NoSuchModelError,\n  type LanguageModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { CerebrasChatLanguageModel } from './cerebras-chat-language-model';\nimport type { CerebrasChatModelId } from './cerebras-chat-options';\nimport { z } from 'zod/v4';\nimport { VERSION } from './version';\n\n// Add error schema and structure\nconst cerebrasErrorSchema = z.object({\n  message: z.string(),\n  type: z.string(),\n  param: z.string(),\n  code: z.string(),\n});\n\nexport type CerebrasErrorData = z.infer<typeof cerebrasErrorSchema>;\n\nconst cerebrasErrorStructure: ProviderErrorStructure<CerebrasErrorData> = {\n  errorSchema: cerebrasErrorSchema,\n  errorToMessage: data => data.message,\n};\n\n/**\n * Cerebras expects assistant reasoning history in the `reasoning` field, while\n * the shared OpenAI-compatible converter serializes it as `reasoning_content`.\n */\nfunction transformCerebrasRequestBody(\n  args: Record<string, any>,\n): Record<string, any> {\n  const {\n    max_tokens: maxTokens,\n    parallelToolCalls,\n    topLogprobs,\n    logitBias,\n    serviceTier,\n    reasoningFormat,\n    promptCacheKey,\n    ...restArgs\n  } = args;\n\n  return {\n    ...restArgs,\n    ...(maxTokens !== undefined && {\n      max_completion_tokens: maxTokens,\n    }),\n    ...(parallelToolCalls !== undefined && {\n      parallel_tool_calls: parallelToolCalls,\n    }),\n    ...(topLogprobs !== undefined && { top_logprobs: topLogprobs }),\n    ...(logitBias !== undefined && { logit_bias: logitBias }),\n    ...(serviceTier !== undefined && { service_tier: serviceTier }),\n    ...(reasoningFormat !== undefined && {\n      reasoning_format: reasoningFormat,\n    }),\n    ...(promptCacheKey !== undefined && {\n      prompt_cache_key: promptCacheKey,\n    }),\n    messages: Array.isArray(args.messages)\n      ? args.messages.map(message => {\n          if (\n            message == null ||\n            typeof message !== 'object' ||\n            message.role !== 'assistant' ||\n            !('reasoning_content' in message)\n          ) {\n            return message;\n          }\n\n          const { reasoning_content, ...rest } = message;\n\n          return {\n            ...rest,\n            ...(!('reasoning' in rest) && reasoning_content !== undefined\n              ? { reasoning: reasoning_content }\n              : {}),\n          };\n        })\n      : args.messages,\n  };\n}\n\nexport interface CerebrasProviderSettings {\n  /**\n   * Cerebras API key.\n   */\n  apiKey?: string;\n  /**\n   * Base URL for the API calls.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface CerebrasProvider extends ProviderV4 {\n  /**\n   * Creates a Cerebras model for text generation.\n   */\n  (modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a Cerebras model for text generation.\n   */\n  languageModel(modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a Cerebras chat model for text generation.\n   */\n  chat(modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\n}\n\nexport function createCerebras(\n  options: CerebrasProviderSettings = {},\n): CerebrasProvider {\n  const baseURL = withoutTrailingSlash(\n    options.baseURL ?? 'https://api.cerebras.ai/v1',\n  );\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'CEREBRAS_API_KEY',\n          description: 'Cerebras API key',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk-cerebras/${VERSION}`,\n    );\n\n  const createLanguageModel = (modelId: CerebrasChatModelId) => {\n    return new CerebrasChatLanguageModel(modelId, {\n      provider: `cerebras.chat`,\n      url: ({ path }) => `${baseURL}${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n      errorStructure: cerebrasErrorStructure,\n      supportsStructuredOutputs: true,\n      transformRequestBody: transformCerebrasRequestBody,\n    });\n  };\n\n  const provider = (modelId: CerebrasChatModelId) =>\n    createLanguageModel(modelId);\n\n  provider.specificationVersion = 'v4' as const;\n  provider.languageModel = createLanguageModel;\n  provider.chat = createLanguageModel;\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'embeddingModel' });\n  };\n  provider.textEmbeddingModel = provider.embeddingModel;\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });\n  };\n\n  return provider;\n}\n\nexport const cerebras = createCerebras();\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/cerebras-chat-language-model.ts","../src/version.ts","../src/cerebras-provider.ts"],"sourcesContent":["import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';\nimport type {\n  LanguageModelV4,\n  LanguageModelV4CallOptions,\n  LanguageModelV4GenerateResult,\n  LanguageModelV4StreamPart,\n  LanguageModelV4StreamResult,\n} from '@ai-sdk/provider';\nimport {\n  serializeModelOptions,\n  WORKFLOW_DESERIALIZE,\n  WORKFLOW_SERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport type { CerebrasChatModelId } from './cerebras-chat-language-model-options';\n\ntype CerebrasChatConfig = ConstructorParameters<\n  typeof OpenAICompatibleChatLanguageModel\n>[1];\n\nfunction isStructuredOutputWithToolCallsFinishReason({\n  rawFinishReason,\n  hasText,\n  responseFormatType,\n}: {\n  rawFinishReason: string | undefined;\n  hasText: boolean;\n  responseFormatType:\n    | NonNullable<LanguageModelV4CallOptions['responseFormat']>['type']\n    | undefined;\n}) {\n  return (\n    responseFormatType === 'json' && rawFinishReason === 'tool_calls' && hasText\n  );\n}\n\nexport class CerebrasChatLanguageModel\n  extends OpenAICompatibleChatLanguageModel\n  implements LanguageModelV4\n{\n  static [WORKFLOW_SERIALIZE](model: CerebrasChatLanguageModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: CerebrasChatModelId;\n    config: CerebrasChatConfig;\n  }) {\n    return new CerebrasChatLanguageModel(options.modelId, options.config);\n  }\n\n  async doGenerate(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4GenerateResult> {\n    const result = await super.doGenerate(options);\n\n    if (\n      !isStructuredOutputWithToolCallsFinishReason({\n        rawFinishReason: result.finishReason.raw,\n        hasText: result.content.some(\n          part => part.type === 'text' && part.text.length > 0,\n        ),\n        responseFormatType: options.responseFormat?.type,\n      })\n    ) {\n      return result;\n    }\n\n    return {\n      ...result,\n      // Cerebras GLM can return valid structured output text while also\n      // repeating a tool call. Treat that mixed response as the final answer.\n      content: result.content.filter(part => part.type !== 'tool-call'),\n      finishReason: {\n        ...result.finishReason,\n        unified: 'stop',\n      },\n    };\n  }\n\n  async doStream(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4StreamResult> {\n    const result = await super.doStream(options);\n    let hasText = false;\n\n    return {\n      ...result,\n      stream: result.stream.pipeThrough(\n        new TransformStream<\n          LanguageModelV4StreamPart,\n          LanguageModelV4StreamPart\n        >({\n          transform(part, controller) {\n            if (part.type === 'text-delta' && part.delta.length > 0) {\n              hasText = true;\n            }\n\n            if (\n              part.type === 'finish' &&\n              isStructuredOutputWithToolCallsFinishReason({\n                rawFinishReason: part.finishReason.raw,\n                hasText,\n                responseFormatType: options.responseFormat?.type,\n              })\n            ) {\n              controller.enqueue({\n                ...part,\n                finishReason: {\n                  ...part.finishReason,\n                  unified: 'stop',\n                },\n              });\n              return;\n            }\n\n            if (\n              options.responseFormat?.type === 'json' &&\n              hasText &&\n              (part.type === 'tool-input-start' ||\n                part.type === 'tool-input-delta' ||\n                part.type === 'tool-input-end' ||\n                part.type === 'tool-call')\n            ) {\n              return;\n            }\n\n            controller.enqueue(part);\n          },\n        }),\n      ),\n    };\n  }\n}\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';\nimport {\n  NoSuchModelError,\n  type LanguageModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  type Resolvable,\n  resolveWith,\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { CerebrasChatLanguageModel } from './cerebras-chat-language-model';\nimport type { CerebrasChatModelId } from './cerebras-chat-options';\nimport { z } from 'zod/v4';\nimport { VERSION } from './version';\n\n// Add error schema and structure\nconst cerebrasErrorSchema = z.object({\n  message: z.string(),\n  type: z.string(),\n  param: z.string(),\n  code: z.string(),\n});\n\nexport type CerebrasErrorData = z.infer<typeof cerebrasErrorSchema>;\n\nconst cerebrasErrorStructure: ProviderErrorStructure<CerebrasErrorData> = {\n  errorSchema: cerebrasErrorSchema,\n  errorToMessage: data => data.message,\n};\n\n/**\n * Cerebras expects assistant reasoning history in the `reasoning` field, while\n * the shared OpenAI-compatible converter serializes it as `reasoning_content`.\n */\nfunction transformCerebrasRequestBody(\n  args: Record<string, any>,\n): Record<string, any> {\n  const {\n    max_tokens: maxTokens,\n    parallelToolCalls,\n    topLogprobs,\n    logitBias,\n    serviceTier,\n    reasoningFormat,\n    promptCacheKey,\n    ...restArgs\n  } = args;\n\n  return {\n    ...restArgs,\n    ...(maxTokens !== undefined && {\n      max_completion_tokens: maxTokens,\n    }),\n    ...(parallelToolCalls !== undefined && {\n      parallel_tool_calls: parallelToolCalls,\n    }),\n    ...(topLogprobs !== undefined && { top_logprobs: topLogprobs }),\n    ...(logitBias !== undefined && { logit_bias: logitBias }),\n    ...(serviceTier !== undefined && { service_tier: serviceTier }),\n    ...(reasoningFormat !== undefined && {\n      reasoning_format: reasoningFormat,\n    }),\n    ...(promptCacheKey !== undefined && {\n      prompt_cache_key: promptCacheKey,\n    }),\n    messages: Array.isArray(args.messages)\n      ? args.messages.map(message => {\n          if (\n            message == null ||\n            typeof message !== 'object' ||\n            message.role !== 'assistant' ||\n            !('reasoning_content' in message)\n          ) {\n            return message;\n          }\n\n          const { reasoning_content, ...rest } = message;\n\n          return {\n            ...rest,\n            ...(!('reasoning' in rest) && reasoning_content !== undefined\n              ? { reasoning: reasoning_content }\n              : {}),\n          };\n        })\n      : args.messages,\n  };\n}\n\nexport interface CerebrasProviderSettings {\n  /**\n   * Cerebras API key.\n   * A function is called before each request and may return a promise.\n   */\n  apiKey?: Resolvable<string>;\n  /**\n   * Base URL for the API calls.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface CerebrasProvider extends ProviderV4 {\n  /**\n   * Creates a Cerebras model for text generation.\n   */\n  (modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a Cerebras model for text generation.\n   */\n  languageModel(modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a Cerebras chat model for text generation.\n   */\n  chat(modelId: CerebrasChatModelId): LanguageModelV4;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\n}\n\nexport function createCerebras(\n  options: CerebrasProviderSettings = {},\n): CerebrasProvider {\n  const baseURL = withoutTrailingSlash(\n    options.baseURL ?? 'https://api.cerebras.ai/v1',\n  );\n  const getHeaders = () =>\n    resolveWith(options.apiKey, apiKey =>\n      withUserAgentSuffix(\n        {\n          Authorization: `Bearer ${loadApiKey({\n            apiKey,\n            environmentVariableName: 'CEREBRAS_API_KEY',\n            description: 'Cerebras API key',\n          })}`,\n          ...options.headers,\n        },\n        `ai-sdk-cerebras/${VERSION}`,\n      ),\n    );\n\n  const createLanguageModel = (modelId: CerebrasChatModelId) => {\n    return new CerebrasChatLanguageModel(modelId, {\n      provider: `cerebras.chat`,\n      url: ({ path }) => `${baseURL}${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n      errorStructure: cerebrasErrorStructure,\n      supportsStructuredOutputs: true,\n      transformRequestBody: transformCerebrasRequestBody,\n    });\n  };\n\n  const provider = (modelId: CerebrasChatModelId) =>\n    createLanguageModel(modelId);\n\n  provider.specificationVersion = 'v4' as const;\n  provider.languageModel = createLanguageModel;\n  provider.chat = createLanguageModel;\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'embeddingModel' });\n  };\n  provider.textEmbeddingModel = provider.embeddingModel;\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });\n  };\n\n  return provider;\n}\n\nexport const cerebras = createCerebras();\n"],"mappings":"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"}

package/docs/40-cerebras.mdx

@@ -87,11 +87,14 @@ You can use the following optional settings to customize the Cerebras provider i
   Use a different URL prefix for API calls.
   The default prefix is `https://api.cerebras.ai/v1`.
 
-- **apiKey** _string_
+- **apiKey** _string | PromiseLike<string> | (() => string | PromiseLike<string>)_
 
   API key that is being sent using the `Authorization` header. It defaults to
   the `CEREBRAS_API_KEY` environment variable.
 
+  A function is called before each request and may return a promise. Use it to
+  supply refreshed credentials; a promise value resolves to the same key each time.
+
 - **headers** _Record<string,string>_
 
   Custom headers to include in the requests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/cerebras",
-  "version": "3.0.81",
+  "version": "3.0.82",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -29,9 +29,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/openai-compatible": "3.0.81",
-    "@ai-sdk/provider": "4.0.34",
-    "@ai-sdk/provider-utils": "5.0.71"
+    "@ai-sdk/openai-compatible": "3.0.82",
+    "@ai-sdk/provider": "4.0.35",
+    "@ai-sdk/provider-utils": "5.0.72"
   },
   "devDependencies": {
     "@types/node": "22.19.19",

package/src/cerebras-provider.ts

@@ -5,6 +5,8 @@ import {
   type ProviderV4,
 } from '@ai-sdk/provider';
 import {
+  type Resolvable,
+  resolveWith,
   loadApiKey,
   withoutTrailingSlash,
   withUserAgentSuffix,
@@ -92,8 +94,9 @@ function transformCerebrasRequestBody(
 export interface CerebrasProviderSettings {
   /**
    * Cerebras API key.
+   * A function is called before each request and may return a promise.
    */
-  apiKey?: string;
+  apiKey?: Resolvable<string>;
   /**
    * Base URL for the API calls.
    */
@@ -138,16 +141,18 @@ export function createCerebras(
     options.baseURL ?? 'https://api.cerebras.ai/v1',
   );
   const getHeaders = () =>
-    withUserAgentSuffix(
-      {
-        Authorization: `Bearer ${loadApiKey({
-          apiKey: options.apiKey,
-          environmentVariableName: 'CEREBRAS_API_KEY',
-          description: 'Cerebras API key',
-        })}`,
-        ...options.headers,
-      },
-      `ai-sdk-cerebras/${VERSION}`,
+    resolveWith(options.apiKey, apiKey =>
+      withUserAgentSuffix(
+        {
+          Authorization: `Bearer ${loadApiKey({
+            apiKey,
+            environmentVariableName: 'CEREBRAS_API_KEY',
+            description: 'Cerebras API key',
+          })}`,
+          ...options.headers,
+        },
+        `ai-sdk-cerebras/${VERSION}`,
+      ),
     );
 
   const createLanguageModel = (modelId: CerebrasChatModelId) => {