luanapi-sdk 0.1.0

OpenAI-compatible Python SDK for Luan API (luanapi.xingluan.cn)

luanapi-sdk

OpenAI-compatible Python SDK for Luan API.

接口格式与 OpenAI Chat Completions 完全兼容，使用习惯接近 openai 官方 SDK：传入 api_key 后即可调用 client.chat.completions.create(...)。

安装

pip install luanapi-sdk

快速开始

from luanapi import LuanAI

client = LuanAI(api_key="YOUR_TOKEN")  # 也可设置环境变量 LUANAPI_API_KEY

# 非流式
resp = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[
        {"role": "system", "content": "你是一个专业、友善的AI助手。"},
        {"role": "user", "content": "hello"},
    ],
    temperature=0.8,
    max_tokens=4096,
)
print(resp["choices"][0]["message"]["content"])

流式调用

stream = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True,
    stream_options={"include_usage": True},
    top_p=1,
    temperature=0.8,
    presence_penalty=0.2,
    frequency_penalty=0.2,
)

for chunk in stream:
    choices = chunk.get("choices") or []
    if choices:
        delta = choices[0].get("delta") or {}
        if delta.get("content"):
            print(delta["content"], end="", flush=True)
    if chunk.get("usage"):
        print("\n[usage]", chunk["usage"])

API

LuanAI(api_key, *, base_url=..., timeout=60, default_headers=None)

参数	说明
api_key	Bearer Token；不传则读取环境变量 LUANAPI_API_KEY。
base_url	默认 https://luanapi.xingluan.cn/runningai/open/v1。
timeout	默认 60s。
default_headers	注入到所有请求的额外 header。

client.chat.completions.create(**kwargs)

接受所有 OpenAI 风格参数：model、messages、temperature、top_p、max_tokens、presence_penalty、frequency_penalty、stream、stream_options、tools、…

• stream=False → 返回 dict
• stream=True → 返回生成器，逐条 yield 已解析的 JSON chunk（自动处理 data: 前缀与 [DONE]）

异常

from luanapi import LuanAPIError, AuthenticationError, APIStatusError

• AuthenticationError：401 或缺少 token
• APIStatusError：非 2xx 响应，包含 status_code、response_body
• LuanAPIError：所有错误的基类

发布到 PyPI

pip install --upgrade build twine
python -m build
python -m twine upload dist/*

发布到 TestPyPI：

python -m twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ luanapi-sdk

License

MIT