對話歷史
可選模組,用於 chat UI 的後端持久化。每個 conversation 是一個有標題/元資料的容器,append message 不觸發 LLM 僅做持久化(配合 chat completions 使用)。完整 CRUD + 訊息追加。
conv = client.conversations.create(title="My Session")
client.conversations.append_message(
conv["conversation_id"], role="user", content="Hello!",
)
all_convs = client.conversations.list(limit=20)
detail = client.conversations.get(conv["conversation_id"])| title | string | Optional | 对话标题。可后续 update。 |
| metadata | object | Optional | 任意 JSON,关联你自己的 user_id / session_id / topic 等。最大 4KB。 |
| role | "user" | "assistant" | "system" | "tool" | Required | 消息角色。 |
| content | string | Required | 消息文本。注意:此 endpoint 只持久化,不触发 LLM。 |
帳號管理
註冊/登入/密碼重設/2FA/資料編輯/GDPR 自助停用。多數 endpoint 面向 web 應用流程;後端整合只需 me() / change-password / 2FA。所有受保護 endpoint 走 Bearer token。
me = client.auth.me()
client.auth.update_profile(full_name="Jane Doe")
client.auth.change_password(
current_password="old-pwd",
new_password="new-pwd-123",
)
status = client.auth.two_fa_status()API Key 管理
動態建立/撤銷 API key,可設定月度消費上限(monthly_spend_cap_usd)、超閾值警告 webhook(HTTPS only)、地理路由策略(cn-only / overseas-only / any)。 create() 傳回 full_key 僅一次,務必儲存。
new = client.keys.create(name="prod-2026")
print(new["full_key"]) # 只此一次显示
client.keys.update_spend_cap(
new["key"]["key_id"],
monthly_spend_cap_usd="100",
)
client.keys.update_alert_webhook(
new["key"]["key_id"],
url="https://your-app.com/billing-alert",
)| name | string | Required | Key 显示名(用于在 dashboard 区分)。1-100 字符。 |
| monthly_spend_cap_usd | string | Optional | 月度上限 USD,字符串保留精度(如 "100.00")。超 cap 后该 key 该月所有请求被拒。 |
| clear | boolean | Default: false | true = 清除当前 cap(无限额)。 |
帳單 / 用量 / 儲值
餘額、每日用量、按檔分項 (by_tier:fast / balanced / passthrough / byok)、Stripe 儲值。計費檔由請求的 model 決定 — model=nexevo/fast → fast 扁平價;傳真實模型 ID → passthrough +5%。所有金額字串請按 decimal 處理,不要 float。
bal = client.billing.balance()
usage = client.billing.usage(days=7)
plan = client.billing.get_plan()
hint = client.billing.upgrade_hint()
if hint["hint"]:
print(f"建议: {hint['hint']['recommend_plan']}, "
f"可省 {hint['hint']['savings_pct']}%")
session = client.billing.checkout(
amount_usd=20,
idempotency_key="topup-2026-04-27-001",
)
print(session["checkout_url"])| amount_usd | number | Required | 充值金额 USD,> 0。 |
| idempotency_key | string | Required | 幂等 key,同 key 重试不会重复扣款。建议格式:topup-YYYY-MM-DD-序号。 |
組織 / 多用戶
企業帳戶的多用戶管理。支援 owner / admin / developer 三種角色,成員邀請/移除/轉讓所有權。所有 key + billing 在組織名下共享,適合公司團隊存取。
org = client.organizations.create("Acme Inc")
client.organizations.invite_member(
org["organization"]["org_id"],
email="dev@acme.com",
role="developer",
)
members = client.organizations.list_members(org["organization"]["org_id"])
client.organizations.transfer_owner(
org["organization"]["org_id"],
new_owner_user_id="u_789",
)RLHF 回饋
從 chat 回應頭 X-Nexevo-Generation-Id 拿 generation_id,提交 thumbs up/down + 可選評論 + tag。回饋直接進資料飛輪,自學習路由會用它優化未來選模型。
resp = client.chat.completions.create(
model="nexevo/balanced",
messages=[{"role": "user", "content": "Hello!"}],
)
gen_id = resp["nexevo"]["generation_id"]
client.feedback.submit(
generation_id=gen_id,
rating=1,
comment="Helpful!",
tags=["accurate"],
)
summary = client.feedback.summary(days=7)| generation_id | string | Required | 从 chat 响应头 X-Nexevo-Generation-Id 或 SDK resp.nexevo.generation_id 拿。 |
| rating | 1 | -1 | Required | 1 = 👍, -1 = 👎。 |
| comment | string | Optional | 可选自由文本(最多 ~2K 字符)。 |
| tags | string[] | Optional | 可选标签。常用: accurate / incorrect / too_verbose / irrelevant。 |