sp-openrouter

Use the callModel function from @openrouter/agent with a model slug and input string, then await result.getText() for the response. Initialize the client with your OPENROUTER_API_KEY environment variable first.

@openrouter/agent provides agent features like callModel, tool definitions, stop conditions, and streaming. @openrouter/sdk covers platform features such as model listing, credits, OAuth, and API key management.

Yes, the result object exposes getTextStream() for text deltas, getReasoningStream() for reasoning tokens, and getToolCallsStream() for tool calls. Multiple consumers can read from a single result concurrently.

Define tools with the tool() helper using Zod schemas for input and output validation, then pass them in the tools array of callModel. The SDK automatically executes tools and continues the conversation until a stop condition is met.

Yes, the SDK supports an OAuth PKCE flow using createAuthCode to generate an authorization URL and exchangeAuthCodeForAPIKey to trade the returned code for a user-specific API key.

A 402 error means the account has no credits and the requested model is paid. Use :free model slugs as a fallback chain and verify current model identifiers at the OpenRouter models endpoint.