Quickstart
Python 快速开始
在 FastAPI、Django 或任意 Python 后端中使用 Nebutra Python SDK。
Python 仅保留用于批处理 / ML / 专用库场景（参考 ADR 2026-05-10，TS-by-Default 后端语言策略）。
CRUD、Webhook、计费、内容管理、第三方 API 代理 —— 一律使用 backends/gateway/（TypeScript + Hono）。新建 Python 服务的前提是至少满足以下一条：
- 批处理 / 队列任务，时长超过 Edge Runtime 容忍范围（>5s）
- 依赖 Python 生态（transformers、vLLM 等）的 ML / 科学计算
- 没有可比拟 TS 端口的专用库
本页面面向已有 Python 服务（FastAPI / Django）中调用 nebutra-sdk 的消费者，不是鼓励为通用业务启动 Python 服务。
安装
pip install nebutra-sdk初始化客户端
import os
from nebutra import Client
nebutra = Client(
api_key=os.environ["NEBUTRA_API_KEY"],
org_id=os.environ["NEBUTRA_ORG_ID"],
)验证 JWT 令牌（FastAPI）
from fastapi import HTTPException, Header
from nebutra import verify_token
import os
async def require_auth(authorization: str = Header(...)):
token = authorization.removeprefix("Bearer ")
try:
return await verify_token(token, api_key=os.environ["NEBUTRA_API_KEY"])
except Exception:
raise HTTPException(status_code=401, detail="无效令牌")检查权限
allowed = await nebutra.permissions.check(
user_id=user_id,
action="delete",
resource="Project",
)
if not allowed:
raise HTTPException(status_code=403, detail="权限不足")相关文档
How is this guide?
在 GitHub 上编辑此页面
最后更新于