content/docs/03-ai-sdk-core/25-settings.mdx

@@ -74,3 +74,29 @@ Maximum number of retries. Set to 0 to disable retries. Default: `2`.
 ### `abortSignal`
 
 An optional abort signal that can be used to cancel the call.
+
+### `headers`
+
+Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
+
+You can use the request headers to provide additional information to the provider,
+depending on what the provider supports. For example, some observability providers support
+headers such as `Prompt-Id`.
+
+```ts
+import { openai } from '@ai-sdk/openai';
+
+const result = await generateText({
+  model: openai('gpt-3.5-turbo'),
+  prompt: 'Invent a new holiday and describe its traditions.',
+  headers: {
+    'Prompt-Id': 'my-prompt-id',
+  },
+});
+```
+
+<Note>
+  The `headers` setting is for request-specific headers. You can also set
+  `headers` in the provider configuration. These headers will be sent with every
+  request made by the provider.
+</Note>

content/docs/07-reference/ai-sdk-core/01-generate-text.mdx

@@ -323,6 +323,13 @@ console.log(text);
       description:
         'An optional abort signal that can be used to cancel the call.',
     },
+    {
+      name: 'headers',
+      type: 'Record<string, string>',
+      isOptional: true,
+      description:
+        'Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.',
+    },
     {
       name: 'maxAutomaticRoundtrips',
       type: 'number',

content/docs/07-reference/ai-sdk-core/02-stream-text.mdx

@@ -325,6 +325,13 @@ for await (const textPart of textStream) {
       description:
         'An optional abort signal that can be used to cancel the call.',
     },
+    {
+      name: 'headers',
+      type: 'Record<string, string>',
+      isOptional: true,
+      description:
+        'Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.',
+    },
     {
       name: 'onFinish',
       type: '(result: OnFinishResult) => void',

content/docs/07-reference/ai-sdk-core/03-generate-object.mdx

@@ -42,29 +42,30 @@ console.log(JSON.stringify(object, null, 2));
     {
       name: 'model',
       type: 'LanguageModel',
-      description: `The language model to use. Example: openai('gpt-4-turbo')`
+      description: `The language model to use. Example: openai('gpt-4-turbo')`,
     },
     {
       name: 'mode',
       type: "'auto' | 'json' | 'grammar' | 'tool'",
       description:
-        "The mode to use for object generation. Not every model supports all modes. Defaults to 'auto'."
+        "The mode to use for object generation. Not every model supports all modes. Defaults to 'auto'.",
     },
     {
-        name: 'schema',
-        type: 'Zod Schema',
-        description: 'The schema that describes the shape of the object to generate. It is sent to the model to generate the object and used to validate the output.'
+      name: 'schema',
+      type: 'Zod Schema',
+      description:
+        'The schema that describes the shape of the object to generate. It is sent to the model to generate the object and used to validate the output.',
     },
     {
       name: 'system',
       type: 'string',
       description:
-        'The system prompt to use that specifies the behavior of the model.'
+        'The system prompt to use that specifies the behavior of the model.',
     },
     {
       name: 'prompt',
       type: 'string',
-      description: 'The input prompt to generate the text from.'
+      description: 'The input prompt to generate the text from.',
     },
     {
       name: 'messages',
@@ -77,22 +78,22 @@ console.log(JSON.stringify(object, null, 2));
             {
               name: 'role',
               type: "'system'",
-              description: 'The role for the system message.'
+              description: 'The role for the system message.',
             },
             {
               name: 'content',
               type: 'string',
-              description: 'The content of the message.'
-            }
-          ]
+              description: 'The content of the message.',
+            },
+          ],
         },
         {
           type: 'CoreUserMessage',
           parameters: [
             {
               name: 'role',
               type: "'user'",
-              description: 'The role for the user message.'
+              description: 'The role for the user message.',
             },
             {
               name: 'content',
@@ -105,42 +106,42 @@ console.log(JSON.stringify(object, null, 2));
                     {
                       name: 'type',
                       type: "'text'",
-                      description: 'The type of the message part.'
+                      description: 'The type of the message part.',
                     },
                     {
                       name: 'text',
                       type: 'string',
-                      description: 'The text content of the message part.'
-                    }
-                  ]
+                      description: 'The text content of the message part.',
+                    },
+                  ],
                 },
                 {
                   type: 'ImagePart',
                   parameters: [
                     {
                       name: 'type',
                       type: "'image'",
-                      description: 'The type of the message part.'
+                      description: 'The type of the message part.',
                     },
                     {
                       name: 'image',
                       type: 'string | Uint8Array | Buffer | ArrayBuffer | URL',
                       description:
-                        'The image content of the message part. String are either base64 encoded content, base64 data URLs, or http(s) URLs.'
-                    }
-                  ]
-                }
-              ]
-            }
-          ]
+                        'The image content of the message part. String are either base64 encoded content, base64 data URLs, or http(s) URLs.',
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
         },
         {
           type: 'CoreAssistantMessage',
           parameters: [
             {
               name: 'role',
               type: "'assistant'",
-              description: 'The role for the assistant message.'
+              description: 'The role for the assistant message.',
             },
             {
               name: 'content',
@@ -153,53 +154,53 @@ console.log(JSON.stringify(object, null, 2));
                     {
                       name: 'type',
                       type: "'text'",
-                      description: 'The type of the message part.'
+                      description: 'The type of the message part.',
                     },
                     {
                       name: 'text',
                       type: 'string',
-                      description: 'The text content of the message part.'
-                    }
-                  ]
+                      description: 'The text content of the message part.',
+                    },
+                  ],
                 },
                 {
                   type: 'ToolCallPart',
                   parameters: [
                     {
                       name: 'type',
                       type: "'tool-call'",
-                      description: 'The type of the message part.'
+                      description: 'The type of the message part.',
                     },
                     {
                       name: 'toolCallId',
                       type: 'string',
-                      description: 'The id of the tool call.'
+                      description: 'The id of the tool call.',
                     },
                     {
                       name: 'toolName',
                       type: 'string',
                       description:
-                        'The name of the tool, which typically would be the name of the function.'
+                        'The name of the tool, which typically would be the name of the function.',
                     },
                     {
                       name: 'args',
                       type: 'object based on zod schema',
                       description:
-                        'Parameters generated by the model to be used by the tool.'
-                    }
-                  ]
-                }
-              ]
-            }
-          ]
+                        'Parameters generated by the model to be used by the tool.',
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
         },
         {
           type: 'CoreToolMessage',
           parameters: [
             {
               name: 'role',
               type: "'tool'",
-              description: 'The role for the assistant message.'
+              description: 'The role for the assistant message.',
             },
             {
               name: 'content',
@@ -212,99 +213,104 @@ console.log(JSON.stringify(object, null, 2));
                     {
                       name: 'type',
                       type: "'tool-result'",
-                      description: 'The type of the message part.'
+                      description: 'The type of the message part.',
                     },
                     {
                       name: 'toolCallId',
                       type: 'string',
                       description:
-                        'The id of the tool call the result corresponds to.'
+                        'The id of the tool call the result corresponds to.',
                     },
                     {
                       name: 'toolName',
                       type: 'string',
                       description:
-                        'The name of the tool the result corresponds to.'
+                        'The name of the tool the result corresponds to.',
                     },
                     {
                       name: 'result',
                       type: 'unknown',
                       description:
-                        'The result returned by the tool after execution.'
+                        'The result returned by the tool after execution.',
                     },
                     {
                       name: 'isError',
                       type: 'boolean',
                       isOptional: true,
                       description:
-                        'Whether the result is an error or an error message.'
-                    }
-                  ]
-                }
-              ]
-            }
-          ]
-        }
-      ]
+                        'Whether the result is an error or an error message.',
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
     },
-
     {
       name: 'maxTokens',
       type: 'number',
       isOptional: true,
-      description: 'Maximum number of tokens to generate.'
+      description: 'Maximum number of tokens to generate.',
     },
     {
       name: 'temperature',
       type: 'number',
       isOptional: true,
       description:
-        'Temperature setting. The value is passed through to the provider. The range depends on the provider and model. It is recommended to set either `temperature` or `topP`, but not both.'
+        'Temperature setting. The value is passed through to the provider. The range depends on the provider and model. It is recommended to set either `temperature` or `topP`, but not both.',
     },
     {
       name: 'topP',
       type: 'number',
       isOptional: true,
       description:
-        'Nucleus sampling. The value is passed through to the provider. The range depends on the provider and model. It is recommended to set either `temperature` or `topP`, but not both.'
+        'Nucleus sampling. The value is passed through to the provider. The range depends on the provider and model. It is recommended to set either `temperature` or `topP`, but not both.',
     },
     {
       name: 'presencePenalty',
       type: 'number',
       isOptional: true,
       description:
-        'Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. The value is passed through to the provider. The range depends on the provider and model.'
+        'Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. The value is passed through to the provider. The range depends on the provider and model.',
     },
     {
       name: 'frequencyPenalty',
       type: 'number',
       isOptional: true,
       description:
-        'Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. The value is passed through to the provider. The range depends on the provider and model.'
+        'Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. The value is passed through to the provider. The range depends on the provider and model.',
     },
     {
       name: 'seed',
       type: 'number',
       isOptional: true,
       description:
-        'The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results.'
+        'The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results.',
     },
     {
       name: 'maxRetries',
       type: 'number',
       isOptional: true,
       description:
-        'Maximum number of retries. Set to 0 to disable retries. Default: 2.'
+        'Maximum number of retries. Set to 0 to disable retries. Default: 2.',
     },
     {
       name: 'abortSignal',
       type: 'AbortSignal',
       isOptional: true,
       description:
-        'An optional abort signal that can be used to cancel the call.'
-    }
-
-]}
+        'An optional abort signal that can be used to cancel the call.',
+    },
+    {
+      name: 'headers',
+      type: 'Record<string, string>',
+      isOptional: true,
+      description:
+        'Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.',
+    },
+  ]}
 />
 
 ### Returns