संसाधन प्रबंधन

#बातचीत का इतिहास

चैट यूआई के बैकएंड दृढ़ता के लिए वैकल्पिक मॉड्यूल। प्रत्येक वार्तालाप शीर्षक/मेटाडेटा वाला एक कंटेनर है। संलग्न संदेश एलएलएम को ट्रिगर नहीं करता है बल्कि केवल बना रहता है (चैट पूर्णता के साथ प्रयोग किया जाता है)। पूर्ण सीआरयूडी + संदेश संलग्न।

python

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"])

POST /conversations

title	`string`	Optional	对话标题。可后续 update。
metadata	`object`	Optional	任意 JSON,关联你自己的 user_id / session_id / topic 等。最大 4KB。

POST /conversations/{id}/messages

role	`"user" \| "assistant" \| "system" \| "tool"`	Required	消息角色。
content	`string`	Required	消息文本。注意:此 endpoint 只持久化,不触发 LLM。

#खाता प्रबंधन

पंजीकरण/लॉगिन/पासवर्ड रीसेट/2एफए/प्रोफाइल संपादन/जीडीपीआर स्वयं-सेवा निष्क्रियकरण। अधिकांश समापन बिंदु वेब अनुप्रयोग प्रवाह के लिए हैं; बैकएंड एकीकरण सिर्फ मैं ()/चेंज-पासवर्ड/2एफए है। सभी संरक्षित समापनबिंदु बियरर टोकन का उपयोग करते हैं।

python

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()

#एपीआई कुंजी प्रबंधन

गतिशील रूप से एपीआई कुंजी बनाएं/निरस्त करें, और मासिक खपत सीमा (मासिक_स्पेंड_कैप_यूएसडी), ओवर-थ्रेसहोल्ड अलार्म वेबहुक (केवल HTTPS), और भौगोलिक रूटिंग नीति (केवल सीएन / केवल विदेशी / कोई भी) निर्धारित कर सकते हैं। create() केवल एक बार पूर्ण_कुंजी लौटाता है, इसे सहेजना सुनिश्चित करें।

पूर्ण_कुंजी केवल एक बार प्रदर्शित होती है

create() द्वारा लौटाई गई फुल_की sk-xc-... पूर्ण स्ट्रिंग है, जिसे स्मार्टिसन फिर कभी प्रदर्शित नहीं करेगा (केवल हैश संग्रहीत है)। बनाते समय तुरंत कुंजी प्रबंधक या .env फ़ाइल में सहेजना सुनिश्चित करें। यदि खो जाए तो इसे केवल पूर्ववत किया जा सकता है और पुनः बनाया जा सकता है।

python

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",
)

POST /keys

name string Required Key 显示名(用于在 dashboard 区分)。1-100 字符。

PATCH /keys/{id}/spend-cap

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 के रूप में पार्स न करें।

राशि के लिए एक स्ट्रिंग का उपयोग करें, पार्सफ्लोट का उपयोग न करें

सभी राशियाँ (बैलेंस_यूएसडी / लागत / राशि_यूएसडी) मूल परिशुद्धता (दशमलव) को बनाए रखते हुए, स्ट्रिंग के रूप में लौटा दी जाती हैं। प्रत्यक्ष पार्सफ्लोट मंटिसा खो सकता है, इसलिए जोड़ और घटाव के लिए दशमलव/बिगनंबर लाइब्रेरी का उपयोग करें।

python

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"])

POST /billing/topup · POST /billing/checkout

amount_usd	`number`	Required	充值金额 USD,> 0。
idempotency_key	`string`	Required	幂等 key,同 key 重试不会重复扣款。建议格式:topup-YYYY-MM-DD-序号。

#संगठन/एकाधिक उपयोगकर्ता

व्यावसायिक खातों का बहु-उपयोगकर्ता प्रबंधन। तीन भूमिकाओं का समर्थन करता है: स्वामी/व्यवस्थापक/डेवलपर, सदस्य आमंत्रण/हटाना/स्थानांतरण स्वामित्व। सभी कुंजियाँ + बिलिंग संगठन के नाम के तहत साझा की जाती हैं, जो कंपनी टीम की पहुंच के लिए उपयुक्त हैं।

python

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",
)

#आरएलएचएफ प्रतिक्रिया

चैट प्रतिक्रिया हेडर X-Nexevo-Generation-Id से जेनरेशन_आईडी प्राप्त करें, अंगूठे ऊपर/नीचे + वैकल्पिक टिप्पणी + टैग सबमिट करें। फीडबैक सीधे डेटा फ्लाईव्हील पर जाता है, और सेल्फ-लर्निंग रूटिंग इसका उपयोग भविष्य के मॉडल चयनों को अनुकूलित करने के लिए करेगा।

python

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)

POST /feedback

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`。

फीडबैक सीधे स्व-शिक्षण रूटिंग पर जाता है

सबमिट किए गए अंगूठे ऊपर/नीचे केवल आँकड़े नहीं हैं - सेल्फ-लर्निंग राउटर (बैंडिट + ईएलओ) वास्तविक समय में भविष्य के चयन मॉडल को समायोजित करने के लिए उनका उपयोग करेगा। अधिक प्रतिक्रिया = उत्पाद की गुणवत्ता में स्वचालित सुधार।

#बातचीत का इतिहास

#खाता प्रबंधन

#एपीआई कुंजी प्रबंधन

#बिल/उपयोग/रिचार्ज

#संगठन/एकाधिक उपयोगकर्ता

#आरएलएचएफ प्रतिक्रिया

अगला कदम

एपीआई कुंजी प्राप्त करें

मॉडल लाइब्रेरी ब्राउज़ करें

कुकबुक उदाहरण