Get an API key
Follow Vercel’s AI Gateway authentication guide to create an AI Gateway API key for the intended team. Configure billing or provider credentials in Vercel as required by the models you plan to use.Configuration
Add Vercel AI Gateway in Settings > Models and paste the key, or set:vercel/<vendor>/<model> prefix and
adds a recommended cross-vendor set. Apply the recommended mapping or choose
models individually for each role.
Cost behavior
Vercel records gateway usage and applies the billing terms, budgets, and upstream provider pricing configured for the team. Roomote records token usage and estimates model cost from metadata; Vercel’s AI Gateway usage and invoice are authoritative. See AI Gateway pricing.Verify setup
- save
AI_GATEWAY_API_KEY - confirm Vercel models appear in Settings > Models
- enable a model and assign it to the coding role
- run a small task and confirm it appears in Vercel AI Gateway usage
Common issues
- The key is rejected. Confirm it is an AI Gateway key for the intended Vercel team, not an unrelated Vercel access token.
- A model cannot be routed. Check model availability, provider credentials, budgets, and routing policy in Vercel.
- A budget blocks tasks. Raise the applicable Vercel budget or select a model and provider route with available capacity.