api_xai 0.3.0

X.AI Grok API client for accessing large language models (LLMs).
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

//! Basic chat completion example.
//!
//! Demonstrates simple chat API usage with the XAI Grok API.
//!
//! Run with:
//! ```bash
//! cargo run --example basic_chat --features integration
//! ```

use api_xai::{ Client, XaiEnvironmentImpl, Secret, ChatCompletionRequest, Message, ClientApiAccessors };

#[ tokio::main ]
async fn main() -> Result< (), Box< dyn core::error::Error > >
{
  // Load API key from workspace or environment
  let secret = Secret::load_with_fallbacks( "XAI_API_KEY" )?;

  // Create environment and client
  let env = XaiEnvironmentImpl::new( secret )?;
  let client = Client::build( env )?;

  println!( "🚀 XAI Grok API - Basic Chat Example\n" );

  // Create a simple chat request
  let request = ChatCompletionRequest::former()
    .model( "grok-2-1212".to_string() )
    .messages( vec![
      Message::user( "What is the capital of France?" )
    ] )
    .max_tokens( 100u32 )
    .form();

  println!( "📤 Sending request to Grok-3..." );

  // Execute the request
  let response = client.chat().create( request ).await?;

  // Display the response
  println!( "✅ Response received:\n" );
  for choice in response.choices
  {
    if let Some( content ) = choice.message.content
    {
      println!( "🤖 Assistant : {content}\n" );
    }
  }

  // Display usage statistics
  println!( "📊 Token Usage:" );
  println!( "   - Prompt : {} tokens", response.usage.prompt_tokens );
  println!( "   - Completion : {} tokens", response.usage.completion_tokens );
  println!( "   - Total : {} tokens", response.usage.total_tokens );

  Ok( () )
}