lumanova 0.0.2.post2

LLM chat and TTS SDK (with built-in MeloTTS)

lumanova SDK

lumanova 是一个集成大模型智能对话与中文文本转语音（TTS，内置 MeloTTS 算法）的 Python SDK，支持一行开箱调用，便于二次开发和各种场景集成。

安装

在根目录下运行： pip install lumanova

快速上手

1.智能对话

from lumanova import Lumanova
client = Lumanova(api_key='your-api-key')

response = client.chat(
    model="qwen3-max-2026-01-23",
    messages=[
        {"role": "system", "content": "Talk like a pirate."},
        {"role": "user", "content": "How do I check if a Python object is an instance of a class? 用中文回答"},
    ],
)
print(response)

api_key：需要在 平台 获取 model：可选模型名称，默认 qwen3.5-plus messages：对话内容（OpenAI 格式）、支持多角色多轮

2.文本转语音（TTS）

from lumanova import LumaTTS

tts = LumaTTS(device='cpu', api_key='your-api-key')
audio_file = tts.tts("你好，世界！", output_path='hello.wav')
print(f"音频已保存至: {audio_file}")

device 默认为 "cpu"，Mac M1/M2 可尝试 "mps"，N卡用户可使用cuda:0 output_path 输出音频路径，可自定义文件名

3.文生图/视频

from lumanova import LumaMM

media = LumaMM(api_key='your-api-key')
media_file = await mm.multimedia("生成一只狗的图片",)
print("生成结果:", media_file)

常见问题

权重加载慢？ TTS 模型首次加载需联网下载权重，之后本地缓存，合成速度极快。 只需随 SDK 一起 pip 安装，无额外依赖。 如遇到 API Key 配置异常或网络问题，可参考错误提示排查。