Uniform access layer for LLMs of China
Project description
aisuite4cn
简单、统一的接口,可连接多个生成式人工智能提供商。
aisuite4cn 针对于中国的各类大模型厂商提供通用的支持。学习了aisuite方案,并开发了该库。
aisuite4cn 使得开发者能够通过标准化的接口轻松使用多个大型语言模型(LLM)。使用类似于OpenAI的接口,aisuite4cn 使得与最受欢迎的LLM互动并比较结果变得简单。它是Python客户端库的轻量级包装器,允许创造者在不改变代码的情况下无缝切换并测试来自不同LLM提供商的响应。我们将在不久的将来扩展它以覆盖更多的用例。
当前支持的提供商包括:
- Moonshot(月之暗面)
- Doubao(火山引擎方舟大模型服务平台)
- Qwen(阿里云千问大模型)
- Hunyuan(腾讯混元大模型)
- Ernie(百度文心一言)
- ZhipuAI(BigModel智谱AI大模型开放平台)
- DeepSeek(深度求索)
- Baichuan(百川智能)
- Spark(讯飞星火)
- Stepfun(阶跃星辰)
- Minimax(Minimax)
- Longcat(美团Longcat大模型)
- Siliconflow(硅基流动大模型)
- DMXAPI(中国多模态大模型API聚合平台)
- Ollama( Get up and running with large language models. )
- Yunwu(云雾)
- iFlytek(讯飞星火)
- Custom(自定义)
安装
你可以只安装基础的 aisuite4cn 包,这只会安装基础包,而不会安装任何提供商的SDK。
或者同时安装某个提供商的包和 aisuite4cn包。
请注意,在 create() 调用中的模型名称使用格式为 <provider>:<model-name>。
aisuite4cn 将根据提供商值调用相应的提供商并传递正确的参数。
提供商的列表可以在目录 aisuite4cn/providers/ 中找到。
支持的提供商的格式为该目录下的 <provider>_provider.py。
pip install aisuite4cn
安装通义千问大模型供应商的包
pip install 'aisuite4cn[qwen]'
安装所有大模型供应商的包
pip install 'aisuite4cn[all]'
配置
你需要为你打算使用的提供商获取 API 密钥。你需要单独安装或在安装 aisuite4cn 时安装特定提供商的库。
API 密钥可以设置为环境变量,也可以作为配置传递给 aisuite4cn 客户端构造函数。你可以使用工具如 python-dotenv 或 direnv 来手动设置环境变量。
以下是一个简短的示例,展示如何使用 aisuite4cn 从 qwen 和 moonshot 生成聊天完成响应。
设置API keys.
export MOONSHOT_API_KEY="your-moonshot-api-key" # 月之暗面开放平台api-key,支持moonshot
export DASHSCOPE_API_KEY="your-dashscope-api-key" # 百炼平台api-key,支持qwen
export ARK_API_KEY = "your-ark-api-key" #火山引擎api-key,支持doubao
export ARK_MODEL_MAP = "modlename1=endpointID&modlename2=endpointID" #火山引擎model map
export HUNYUAN_API_KEY = "your-hunyuan-api-key" #腾讯混元api-key,支持混元
export ZHIPUAI_API_KEY = "your-zhipuai-api-key" #智谱AI api-key,支持ChatGLM
export QIANFAN_ACCESS_KEY = "your-qianfan-access-key" #百度千帆 access key,支持文心一言
export QIANFAN_SECRET_KEY = "your-qianfan-secret-key" #百度千帆 secret key,支持文心一言
export DEEPSEEK_API_KEY="your-deepseek-api-key" # deepseek开放平台api-key,支持deepseek
export BAICHUAN_API_KEY="your-baichuan-api-key" # 百川智能api-key
export MINIMAX_API_KEY="your-minimax-api-key" # MiniMax api-key
export STEP_API_KEY="your-step-api-key" # 阶跃星辰 api-key
export YUNWU_API_KEY="your-yunwu-api-key" # 云雾 api-key
export SPARK_API_KEY_MAP = "modlename1=your-modelname1-api-key&modlename2=your-modelname1-api-key" # 讯飞星火api-key-map
export IFLYTEK_API_KEY="your-iflytek-api-key" # 讯飞星火 x2 api-key
export DMXAPI_API_KEY="your-dmxapi-api-key" # dmxapi api-key,支持dmxapi
export LONGCAT_API_KEY="your-longcat-api-key" # 美团 longcat api-key
export SILICONFLOW_API_KEY="your-siliconflow-api-key" # 硅基流动 api-key,支持硅基流
export CUSTOM_BASE_URL="your-custom-base-url" # 自定义提供商的base-url
export CUSTOM_API_KEY="your-custom-api-key" # 自定义提供商的api-key
使用python客户端
import aisuite4cn as ai
client = ai.Client()
models = [
"spark:4.0Ultra",
"spark:generalv3",
"ark:Doubao-pro-32k",
"qwen:qwen-max",
"moonshot:moonshot-v1-8k",
"hunyuan:hunyuan-standard",
"qianfan:ernie-3.5-8k",
"zhipuai:glm-4-flash",
"deepseek:deepseek-chat",
"longcat:LongCat-Flash-Chat"
]
messages = [
{"role": "system", "content": "Respond in Pirate English."},
{"role": "user", "content": "Tell me a joke."},
]
for model in models:
response = client.chat.completions.create(
model=model,
messages=messages,
temperature=0.75
)
print(response.choices[0].message.content)
License
aisuite4cn 在 MIT 许可证下发布。您可以自由地将代码用于商业和非商业目的。
Integrated Open source project
Special thanks to all contributors
aisuite
https://github.com/andrewyng/aisuite
openai-python
https://github.com/openai/openai-python
Development Guide
Please refer to DEVELOPMENT.md for detailed development and installation instructions.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aisuite4cn-1.1.9.tar.gz.
File metadata
- Download URL: aisuite4cn-1.1.9.tar.gz
- Upload date:
- Size: 32.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
02b0403dbe06ccf46a9933d16eee81954ea1edaa382418bd5f9f61cc3796a78d
|
|
| MD5 |
233bf3d17214be670e2fa7e3146dcb66
|
|
| BLAKE2b-256 |
088fb9f51a83a51b1371468087f0bae21139c800d4402353c7e89a5f7837f579
|
File details
Details for the file aisuite4cn-1.1.9-py3-none-any.whl.
File metadata
- Download URL: aisuite4cn-1.1.9-py3-none-any.whl
- Upload date:
- Size: 45.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0d5f58ef677b323e1e87fcdcc2d7c62c8af8064f1bb6bb81571249d19332b151
|
|
| MD5 |
6892c74b0ed891b74ee7e827d32e96ad
|
|
| BLAKE2b-256 |
31d4051f687c96070d263c795b83b7b75284a76a55325c72e43dba15a88d8f88
|