Crate async_translate

Crate async_translate 

Source
Expand description

§async-translate

一个支持并发的翻译库,目前支持 OpenAI 和微软翻译服务。

§功能特性

  • 支持 OpenAI 翻译接口
    • 支持自定义 base URL、模型、API Key
    • 支持多 API Key 配置,每个 Key 单独计算并发数和 RPM
    • RPM 和并发数可选配置,具备默认数值
  • 支持微软翻译接口
    • 自动获取临时认证token,无需配置API密钥
    • 支持并发操作
  • 统一的翻译接口,易于扩展
  • 类型安全的语言标识符支持
  • 可配置的超时和重试机制

§使用方法

use async_translate::{TranslationManager, OpenAITranslator, OpenAIConfig, MicrosoftTranslator, MicrosoftConfig, LanguageIdentifier, TranslateOptions};
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建翻译管理器
    let mut manager = TranslationManager::new();

    // 配置 OpenAI 翻译器
    let openai_config = OpenAIConfig {
        base_url: "https://api.openai.com/v1".to_string(),
        model: "gpt-3.5-turbo".to_string(),
        api_keys: vec!["your-openai-api-key".to_string()],
        rpm_limit: 60,
        concurrent_limit: 10,
        system_prompt: None,
    };
    let openai_translator = Box::new(OpenAITranslator::new(openai_config));
    manager.add_translator("openai", openai_translator);

    // 配置微软翻译器(自动获取认证token)
    let microsoft_config = MicrosoftConfig {
        endpoint: None,  // 使用默认端点
        api_key: None,   // 使用自动认证
        concurrent_limit: 10,
    };
    let microsoft_translator = Box::new(MicrosoftTranslator::new(microsoft_config));
    manager.add_translator("microsoft", microsoft_translator);

    // 执行翻译
    let text = "Hello, world!";
    let target_lang: LanguageIdentifier = "zh".parse().unwrap();

    // 基本翻译(使用默认配置)
    let result = manager.translate("openai", text, &target_lang, None).await?;
    println!("OpenAI Translation: {}", result);

    // 带配置的翻译
    let options = TranslateOptions::default()
        .timeout(Duration::from_secs(60))
        .max_retries(5);
    let result = manager.translate_with_options("microsoft", text, &target_lang, None, &options).await?;
    println!("Microsoft Translation: {}", result);

    Ok(())
}

Re-exports§

pub use error::TranslationError;
pub use manager::TranslationManager;
pub use microsoft::MicrosoftConfig;
pub use microsoft::MicrosoftTranslator;
pub use openai::OpenAIConfig;
pub use openai::OpenAITranslator;
pub use options::TranslateOptions;
pub use translator::Translator;

Modules§

error
翻译错误类型定义
manager
翻译管理器实现
microsoft
微软翻译器实现
openai
OpenAI 翻译器实现
options
翻译配置选项
translator
翻译器trait定义

Structs§

LanguageIdentifier
LanguageIdentifier is a core struct representing a Unicode Language Identifier.