suanlinfang-sdk

算邻坊（suanlinfang.cn）开放 API 的 Python 客户端，覆盖四条产品线：

安装

pip install suanlinfang-sdk

快速开始

from suanlinfang import SuanlinfangClient

client = SuanlinfangClient(api_key="nk-xxxx")   # 控制台创建：https://suanlinfang.cn/consume-web/api-keys.html

# 语音转文字（≤3 分钟短音频，公网 URL）
result = client.stt.transcribe_url("https://example.com/audio.wav")
print(result.text)

# 文字转语音
result = client.tts.synthesize("你好，算邻坊", speaker="suwan", audio_format="mp3")
print(result.url)                                # 现签下载链接，1 小时内有效

# 图片文字识别
result = client.ocr.recognize_url("https://example.com/img.png", tier="standard")
print(result.words)

# 智能决策
result = client.decision.decide(
    state="订单金额 4980 元，物流显示签收但用户否认收货",
    questions={"severity": {"type": "score", "criteria": ["轻微", "一般", "严重"]}},
)
print(result.answers)

长音频/长文本/PDF 走异步任务三步流：submit_task → get_task 轮询 → 终态取结果，状态机 queued/running/success/failed，终态保留 72 小时。

配置

• 新用户注册即赠 ¥10 体验金：https://suanlinfang.cn
• 错误统一为 SuanlinfangApiError（含 status_code / code / request_id / retryable）；5xx 自动退避重试，超时不自动重试（防重复计费）