x-ai 0.1.0

✨ A cli, tui, and sdk for interacting with the 𝕏-AI API
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

// Copyright 2026 Mahmoud Harmouch.
//
// Licensed under the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.

#![allow(async_fn_in_trait)]

use crate::api_key::ApiKeyInfo;
use crate::chat_compl::ChatCompletionRequest;
use crate::chat_compl::ChatCompletionResponse;
use crate::completions::CompletionsRequest;
use crate::completions::CompletionsResponse;
use crate::embedding::EmbeddingRequest;
use crate::embedding::EmbeddingResponse;
use crate::embedding_get::EmbeddingModelResponse;
use crate::embedding_mod::EmbeddingModelsResponse;
use crate::error::XaiError;
use crate::get_mod::ModelInfoResponse;
use crate::lang_mod::LanguageModelDetailResponse;
use crate::list_lang_mod::LanguageModelListResponse;
use crate::list_mod::ReducedModelListResponse;
use crate::responses::{CreateResponseRequest, DeleteResponseObject, ResponseObject};
use reqwest::{Method, RequestBuilder};

pub trait ClientConfig {
    fn set_api_key(&self, api_key: String);
    fn get_api_key(&self) -> Option<String>;
    fn request(&self, method: Method, endpoint: &str) -> Result<RequestBuilder, XaiError>;
}

pub trait ApiKeyFetcher {
    async fn fetch_api_key_info(&self) -> Result<ApiKeyInfo, XaiError>;
}

pub trait ChatCompletionsFetcher {
    async fn create_chat_completion(
        &self,
        request: ChatCompletionRequest,
    ) -> Result<ChatCompletionResponse, XaiError>;
}

pub trait CompletionsFetcher {
    async fn create_completions(
        &self,
        request: CompletionsRequest,
    ) -> Result<CompletionsResponse, XaiError>;
}

pub trait EmbeddingFetcher {
    async fn create_embedding(
        &self,
        request: EmbeddingRequest,
    ) -> Result<EmbeddingResponse, XaiError>;
}

pub trait EmbeddingModelsFetcher {
    async fn list_embedding_models(&self) -> Result<EmbeddingModelsResponse, XaiError>;
}

pub trait EmbeddingModelFetcher {
    async fn fetch_model_info(&self) -> Result<EmbeddingModelResponse, XaiError>;
}

pub trait ModelFetcher {
    async fn fetch_model_info(&self) -> Result<LanguageModelListResponse, XaiError>;
}

pub trait GetModelFetcher {
    async fn fetch_model_info(&self) -> Result<LanguageModelDetailResponse, XaiError>;
}

pub trait ListModelFetcher {
    async fn fetch_model_info(&self) -> Result<ReducedModelListResponse, XaiError>;
}

pub trait ModelInfoFetcher {
    async fn fetch_model_info(&self) -> Result<ModelInfoResponse, XaiError>;
}

pub trait DeferredCompletionFetcher {
    async fn fetch_deferred_completion(
        &self,
        request_id: &str,
    ) -> Result<Option<ChatCompletionResponse>, XaiError>;
}

pub trait ResponsesFetcher {
    async fn create_response(
        &self,
        request: CreateResponseRequest,
    ) -> Result<ResponseObject, XaiError>;
    async fn get_response(&self, response_id: &str) -> Result<ResponseObject, XaiError>;
    async fn delete_response(&self, response_id: &str) -> Result<DeleteResponseObject, XaiError>;
}
// Copyright 2026 Mahmoud Harmouch.
//
// Licensed under the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.