@ai-sdk/openai 3.0.136 → 3.0.138

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @ai-sdk/openai
 
+## 3.0.138
+
+### Patch Changes
+
+- c6d995a: fix(openai): surface Chat Completions refusals as text content
+
+  The Chat Completions model ignored `message.refusal` (non-streaming) and `delta.refusal` (streaming). When the model refused to answer, `content` was `null`, so the AI SDK returned empty text with a `stop` finish reason and silently dropped the refusal. Refusal text is now emitted as text content in both `generateText` and `streamText` results, and it is emitted in addition to content when the API returns both. A refusal with a `stop` finish reason is now reported as a `content-filter` finish reason, matching the Anthropic provider and the Responses API.
+
+- 98eb47b: fix(openai,openai-compatible): surface refusal logprobs and openai-compatible refusals
+
+  `@ai-sdk/openai`: Chat Completions responses that contain a refusal can return `logprobs.refusal` next to `logprobs.content`. The provider previously read only `logprobs.content`, so `providerMetadata.openai.logprobs` was empty or missing for refusals. Refusal logprobs are now included in emission order (content logprobs followed by refusal logprobs) in both `generateText` and `streamText`.
+
+  Streaming logprobs are now collected across all chunks in `streamText`: previously only the logprobs of the last streamed chunk were reported. This applies to content logprobs as well, so `providerMetadata.openai.logprobs` now contains the logprobs of every streamed token instead of only the last chunk's tokens. Explicitly empty logprobs (`logprobs: { content: [], refusal: null }`) are reported as an empty array, as before.
+
+  A refusal that arrives in the same streamed chunk as the `finish_reason` is now taken into account: such a response is reported with a `content-filter` finish reason instead of `stop`.
+
+  `@ai-sdk/openai-compatible`: Chat Completions responses that carry `message.refusal` (non-streaming) or `delta.refusal` (streaming) were ignored, so providers such as OpenAI served through `createOpenAICompatible` lost the refusal text and reported an empty `stop` response. Refusals are now returned as text content after any content text, and a non-empty refusal with a `stop` finish reason is reported as a `content-filter` finish reason. This also applies when the refusal and the finish reason arrive in the same streamed chunk. Non-string refusals (for example `refusal: false` from servers that use booleans) are ignored instead of failing the response.
+
+- c21fadf: fix(openai): handle refusal content parts in the Responses API
+
+  The Responses API returns a `refusal` content part instead of `output_text` when the model declines a request. The response schema rejected these parts, so non-streaming calls failed with an `APICallError` ("Invalid JSON response"), and streamed `response.refusal.delta` / `response.refusal.done` events were dropped, producing empty text. Refusal content parts and stream events are now parsed: the refusal explanation is surfaced as text and the finish reason is mapped to `content-filter`. When the response also contains a client-side function call, the finish reason stays `tool-calls` so the tools are still executed.
+
+## 3.0.137
+
+### Patch Changes
+
+- afde897: feat(openai): support GPT Image 2.6 models with `complexity`, markup-guided edits (`markup`), animated GIF output (`outputFormat: 'gif'`, `frameCount`, `frameDurationMs`), and `safetyIdentifier` for image models
+
 ## 3.0.136
 
 ### Patch Changes

package/dist/index.d.mts

@@ -46,22 +46,28 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.6-flare' | 'gpt-image-2.6-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
 declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
 }>;
 type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
 declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
-    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     style?: "vivid" | "natural" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | "gif" | undefined;
+    frameCount?: number | undefined;
+    frameDurationMs?: number | undefined;
     moderation?: "low" | "auto" | undefined;
 }>;
 type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
@@ -69,9 +75,12 @@ declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     inputFidelity?: "low" | "high" | undefined;
+    markup?: string | undefined;
 }>;
 type OpenAIImageModelEditOptions = InferSchema<typeof openaiImageModelEditOptions>;
 
@@ -232,6 +241,18 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             logprob: number;
         }[];
     }[] | null | undefined;
+} | {
+    type: "response.refusal.delta";
+    item_id: string;
+    delta: string;
+    output_index?: number | null | undefined;
+    content_index?: number | null | undefined;
+} | {
+    type: "response.refusal.done";
+    item_id: string;
+    refusal: string;
+    output_index?: number | null | undefined;
+    content_index?: number | null | undefined;
 } | {
     type: "response.completed" | "response.incomplete";
     response: {

package/dist/index.d.ts

@@ -46,22 +46,28 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.6-flare' | 'gpt-image-2.6-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
 declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
 }>;
 type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
 declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
-    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     style?: "vivid" | "natural" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | "gif" | undefined;
+    frameCount?: number | undefined;
+    frameDurationMs?: number | undefined;
     moderation?: "low" | "auto" | undefined;
 }>;
 type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
@@ -69,9 +75,12 @@ declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     inputFidelity?: "low" | "high" | undefined;
+    markup?: string | undefined;
 }>;
 type OpenAIImageModelEditOptions = InferSchema<typeof openaiImageModelEditOptions>;
 
@@ -232,6 +241,18 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             logprob: number;
         }[];
     }[] | null | undefined;
+} | {
+    type: "response.refusal.delta";
+    item_id: string;
+    delta: string;
+    output_index?: number | null | undefined;
+    content_index?: number | null | undefined;
+} | {
+    type: "response.refusal.done";
+    item_id: string;
+    refusal: string;
+    output_index?: number | null | undefined;
+    content_index?: number | null | undefined;
 } | {
     type: "response.completed" | "response.incomplete";
     response: {