ds_api/
lib.rs

1//! # DeepSeek API Rust Client
2//!
3//! 一个功能完整的 Rust 客户端库，用于与 DeepSeek API 进行交互。
4//!
5//! ## 特性
6//!
7//! - **完整的 API 支持**: 支持 DeepSeek API 的所有功能
8//! - **类型安全**: 使用 Rust 的强类型系统确保 API 请求和响应的正确性
9//! - **异步支持**: 基于 `tokio` 和 `reqwest` 的异步实现
10//! - **流式响应**: 支持 Server-Sent Events (SSE) 流式响应
11//! - **工具调用**: 支持函数调用和工具选择
12//! - **JSON 模式**: 支持 JSON 格式的响应
13//! - **推理模式**: 支持 DeepSeek Reasoner 模型的推理功能
14//!
15//! ## 快速开始
16//!
17//! ```no_run
18//! use ds_api::{Request, Message, Role, Response};
19//!
20//! #[tokio::main]
21//! async fn main() -> ds_api::error::Result<()> {
22//!     let token = "your_deepseek_api_token".to_string();
23//!
24//!     let request = Request::basic_query(vec![
25//!         Message::new(Role::User, "Hello, how are you?")
26//!     ]);
27//!
28//!     let response = request.execute_nostreaming(&token).await?;
29//!     // 注意：`Response::content()` 现在返回 `Result<&str, ApiError>`，需处理潜在错误
30//!     let content = response.content()?;
31//!     println!("Response: {}", content);
32//!     Ok(())
33//! }
34//! ```
35//!
36//! ## 模块概览
37//!
38//! - [`request`]
39//! - [`response`]
40//! - [`normal_chatter`]
41//! - [`simple_chatter`]
42//! - [`raw`]
43//!
44//! ## 更多示例
45//!
46//! 查看各个模块的文档和 `examples/` 目录获取更多使用示例。
47
48pub mod error;
49pub mod normal_chatter;
50pub mod raw;
51pub mod request;
52pub mod response;
53pub mod simple_chatter;
54
55/// 重新导出常用的类型，方便用户使用
56pub use normal_chatter::{History, NormalChatter};
57pub use request::Request;
58pub use response::Response;
59pub use simple_chatter::SimpleChatter;
60
61/// 重新导出原始数据结构
62pub use raw::*;
ds_api/lib.rs

ds_api/
lib.rs
