Skip to content

fix (provider/gateway): improve error message on client side timeouts #12407

Merged
gr2m merged 7 commits intovercel:mainfrom
mclenhard:feat/improve-gateway-timeout-error
Feb 11, 2026
Merged

fix (provider/gateway): improve error message on client side timeouts #12407
gr2m merged 7 commits intovercel:mainfrom
mclenhard:feat/improve-gateway-timeout-error

Conversation

@mclenhard
Copy link
Copy Markdown
Contributor

@mclenhard mclenhard commented Feb 10, 2026

Background

Client side timeouts were confusing to the user, so we wanted to improve the error message to link to the docs and explain how to modify fetch and undci header timeouts.

Summary

Manual Verification

pnpm tsx src/generate-text/gateway-timeout.ts

Checklist

  • Tests have been added / updated (for bug fixes / features)
  • Documentation has been added / updated (for bug fixes / features)
  • A patch changeset for relevant packages has been added (for bug fixes / features - run pnpm changeset in the project root)
  • I have reviewed this pull request (self-review)

Future Work

Related Issues

Copy link
Copy Markdown
Contributor

@vercel vercel bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional Suggestion:

Missing await on async asGatewayError() in gateway-video-model.ts and gateway-image-model.ts causes a Promise object to be thrown instead of a GatewayError.

Fix on Vercel

}): GatewayTimeoutError {
const message = `Gateway request timed out: ${originalMessage}

This is a client-side timeout. To resolve this, increase your timeout configuration: https://vercel.com/docs/ai-gateway/capabilities/video-generation#extending-timeouts-for-node.js`;
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@gr2m gr2m merged commit a2208a2 into vercel:main Feb 11, 2026
17 of 18 checks passed
mclenhard added a commit to mclenhard/ai that referenced this pull request Feb 11, 2026
…vercel#12407)

Client side timeouts were confusing to the user, so we wanted to improve
the error message to link to the docs and explain how to modify fetch
and undci header timeouts.

```
pnpm tsx src/generate-text/gateway-timeout.ts
```
shaper added a commit that referenced this pull request Feb 13, 2026
## Background

This is a manual backport of
[12407](#12407) to the release-v5.0
branch.

## Summary

Client side timeouts were confusing to the user, so we wanted to improve
the error message to link to the docs and explain how to modify fetch
and undci header timeouts.

## Manual Verification

`pnpm tsx src/generate-text/gateway-timeout.ts`

## Checklist

<!--
Do not edit this list. Leave items unchecked that don't apply. If you
need to track subtasks, create a new "## Tasks" section

Please check if the PR fulfills the following requirements:
-->

- [ ] Tests have been added / updated (for bug fixes / features)
- [ ] Documentation has been added / updated (for bug fixes / features)
- [ ] A _patch_ changeset for relevant packages has been added (for bug
fixes / features - run `pnpm changeset` in the project root)
- [ ] I have reviewed this pull request (self-review)

## Future Work

<!--
Feel free to mention things not covered by this PR that can be done in
future PRs.
Remove the section if it's not needed.
 -->

## Related Issues

<!--
List related issues here, e.g. "Fixes #1234".
Remove the section if it's not needed.
-->

---------

Co-authored-by: Walter Korman <shaper@vercel.com>
@gr2m gr2m added ai/provider related to a provider package. Must be assigned together with at least one `provider/*` label provider/gateway Issues related to the @ai-sdk/gateway provider and removed ai/gateway labels Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai/provider related to a provider package. Must be assigned together with at least one `provider/*` label provider/gateway Issues related to the @ai-sdk/gateway provider

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants