openrouter-rs 0.5.2

A type-safe OpenRouter Rust SDK
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

use openrouter_rs::{
    OpenRouterClient,
    api::chat::{ChatCompletionRequest, Message},
    types::{Choice, ResponseFormat, Role},
};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let api_key = std::env::var("OPENROUTER_API_KEY").expect("OPENROUTER_API_KEY must be set");
    let client = OpenRouterClient::builder()
        .api_key(api_key)
        .http_referer("https://github.com/realmorrisliu/openrouter-rs")
        .x_title("openrouter-rs")
        .build()?;

    let format = ResponseFormat::json_schema(
        "character_info",
        true,
        serde_json::json!({
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Name of the character",
            },
            "school": {
              "type": "string",
              "description": "School of the character",
            },
            "hair_color": {
              "type": "string",
              "description": "Hair color of the character",
            },
          },
        }),
    );

    let chat_request = ChatCompletionRequest::builder()
        .model("google/gemini-2.5-pro-exp-03-25:free")
        .messages(vec![Message::new(Role::User, "Who is Harry Potter?")])
        .response_format(format)
        .build()?;

    let chat_response = client.send_chat_completion(&chat_request).await?;

    println!("=== Chat Response:");
    println!("{chat_response:?}");

    println!("=== Structured Response:");
    for choice in chat_response.choices {
        if let Choice::NonStreaming(non_streaming_choice) = choice {
            if let Some(content) = non_streaming_choice.message.content {
                println!("{content}");
            }
        }
    }

    Ok(())
}