Python SDK

HiAPI 官方 Python 客户端，封装统一异步接口：提交生成任务、等待完成、读取产物，一次调用即可完成。

• 包： PyPI 上的 hiapi · GitHub 源码
• 零运行时依赖——纯标准库。
• Python 3.8+，完整类型标注（内置 py.typed）。
• 内置 webhook 签名验签。

安装

pip install hiapi

快速开始

提交任务、跟踪进度、读取结果：

from hiapi import HiAPI

client = HiAPI(api_key="sk-...")  # 或设置 HIAPI_API_KEY 环境变量

task = client.tasks.run(
    model="seedance-2-0",
    input={"prompt": "a cyan glass data center entrance", "resolution": "1080p"},
    on_update=lambda t: print(t.status),
)
for out in task.output:
    print(out.type, out.url)

client.tasks.run() 提交任务并阻塞直到终态。底层的 create、retrieve、list、wait 方法，webhook 验签，异常层级，以及客户端配置，详见 README。