openrouter-rust

An idiomatic, async Rust SDK for the OpenRouter API. A Rust port of openrouter-go; behavior and defaults are kept in sync with the Go SDK on purpose.

Install

cargo add openrouter-client

The crate is published as openrouter-client on crates.io (openrouter, openrouter-rust, and openrouter-rs were all already taken), but it imports as openrouter — your code writes use openrouter::....

MSRV is 1.75. Optional beta feature gates the Responses API:

[dependencies]
openrouter-client = { version = "0.1", features = ["beta"] }

Quickstart

use openrouter::{ChatCompletionRequest, Client, Message};

#[tokio::main]
async fn main() -> openrouter::Result<()> {
    let client = Client::builder()
        .api_key(std::env::var("OPENROUTER_API_KEY").unwrap())
        .app_name("my-app")
        .build()?;

    let req = ChatCompletionRequest::new(
        "google/gemini-3.1-flash-lite",
        vec![Message::user("Hello, who are you?")],
    );
    let resp = client.chat_complete(req).await?;
    if let Some(text) = resp.choices.first()
        .and_then(|c| c.message.as_ref())
        .and_then(|m| m.content_text())
    {
        println!("{text}");
    }
    Ok(())
}

Streaming:

use futures::StreamExt;
use openrouter::{ChatCompletionRequest, Client, Message};

# async fn run() -> openrouter::Result<()> {
let client = Client::builder().api_key("sk-…").build()?;
let req = ChatCompletionRequest::new(
    "google/gemini-3.1-flash-lite",
    vec![Message::user("Stream a haiku.")],
);
let mut stream = client.chat_complete_stream(req).await?;
while let Some(chunk) = stream.next().await {
    let chunk = chunk?;
    if let Some(delta) = chunk.choices.first()
        .and_then(|c| c.delta.as_ref())
        .and_then(|d| d.content.as_deref())
    {
        print!("{delta}");
    }
}
# Ok(()) }

Features

Recipes

In-tree recipes are embedded in rustdoc and viewable on docs.rs:

• Quickstart
• Streaming
• Tools
• Structured outputs
• Multimodal
• Provider routing
• ZDR
• Key management

End-to-end smoke tests

The e2e example is a single binary that mirrors the Go SDK's cmd/openrouter-test/ layout. Every subcommand hits the live OpenRouter API using google/gemini-3.1-flash-lite by default.

OPENROUTER_API_KEY=sk-... cargo run --example e2e -- --help
OPENROUTER_API_KEY=sk-... cargo run --example e2e -- chat
OPENROUTER_API_KEY=sk-... cargo run --example e2e -- stream
OPENROUTER_API_KEY=sk-... cargo run --example e2e -- tools

Subcommands: chat, stream, completion, tools, transforms, websearch, models, endpoints, providers, credits, activity, key, listkeys, createkey, updatekey, deletekey. The *key provisioning subcommands require a provisioning key, not a runtime key.

Roadmap

Reference

• Go SDK this port is based on: https://github.com/hra42/openrouter-go
• OpenRouter API docs: https://openrouter.ai/docs
• Changelog: CHANGELOG.md
• AI agent guide: AGENTS.md

License

Released into the public domain under The Unlicense. Same license as the Go SDK.