🛡️ 潇楠 Web3哨兵 · Python SDK

一个 API Key，调用 20+ AI 功能。覆盖文本对话、文生图、文生视频、TTS、播客、市场分析、安全检测等全部能力。

📦 安装

pip install xiaonan-web3

要求：Python 3.8 及以上版本。

🚀 快速开始

1. 购买 API Key

2. 在代码中初始化客户端

   from xiaonan import Client

   client = Client(api_key="sk-你的Key")

📋 功能列表

💻 代码示例

文本对话

from xiaonan import Client

client = Client(api_key="sk-你的Key")

reply = client.chat("你好，请介绍一下你自己")
print(reply)

# 指定模型
reply = client.chat("分析一下今天的行情", model="deepseek-v4-flash")

文生图

image_url = client.image("一只在月亮下奔跑的狼")
print(image_url)

# 指定尺寸
image_url = client.image("赛博朋克城市夜景", size="1024x1024")

文生视频

task = client.video("海浪拍打礁石的慢动作", width=1920, height=1080)
video_url = task.wait()  # 自动轮询直到完成
print(video_url)

TTS 文本转语音

audio_url = client.tts("你好世界，欢迎使用潇楠Web3哨兵")
print(audio_url)

AI 一键创作

article = client.article("Web3发展趋势", length="short")
print(article['title'])
print(article['content'])

市场数据 + AI 分析

data = client.market("BTCUSDT")
print(data['ai_analysis'])

风控检查

report = client.risk(pair="BTCUSDT", side="long", leverage=10)
print(f"风险等级: {report['risk_report']['level']}")

代币安全检测

result = client.token_check("0x55d398326f99059fF775485246999027B3197955")
print(f"风险等级: {result['raw_data']['risk_level']}")
print(result['ai_analysis'])

查询配额

info = client.quota()
print(f"总: {info['total_quota']}, 已用: {info['used_quota']}, 剩余: {info['remaining']}")

❗ 错误处理

SDK 在所有 API 调用失败时抛出 XiaoNanError 异常，包含 HTTP 状态码和中文错误提示：

from xiaonan import Client
from xiaonan.errors import XiaoNanError

client = Client(api_key="sk-你的Key")

try:
    reply = client.chat("你好")
except XiaoNanError as e:
    print(f"调用失败: {e}")

🔗 相关资源

📄 License

MIT © 2026 潇楠 Web3实验室