Metis Python SDK

Metis 应用后端 SDK，用于读取统一应用身份、可信请求上下文、声明的 Web/Service 依赖，以及模型和对象存储配置。

安装

python -m pip install metis-platform-sdk

from metis_sdk import from_env

client = from_env()
for dependency in client.list_dependencies():
    print(dependency["app_id"])
embedding = client.model("embedding.0")
rerank = client.model("rerank.0")
print(embedding["model"], rerank["model"])

model() 支持 llm.N、embedding.N 和 rerank.N 三类 slot，并返回对应的网关地址、模型别名、API key 及类型专属参数。SDK 不创建厂商客户端。

list_runtime_models() 返回当前应用已绑定 slot 的展示名称、图标、能力、上下文限制和繁忙度，不返回 API key 或供应商凭据：

for model in client.list_runtime_models():
    print(model.slot, model.display_name, model.busy_level)

模型 slot API key 始终必填，请显式选择最终用户归因：

from metis_sdk import platform_identity_from_request, with_external_user, without_user_attribution

request = model.new_request("POST", "/v1/chat/completions", platform_identity_from_request(incoming_request), body)
request = model.new_request("POST", "/v1/chat/completions", with_external_user("customer-42"), body)
request = model.new_request("POST", "/v1/embeddings", without_user_attribution(), body)

优先从平台保护入口的可信请求头构造平台用户归因。外部用户归因只适用于应用已自行认证的用户；无法对应到个人的后台任务才归入其他用户。浏览器端不得持有模型 slot API key。

运行环境必须提供 METIS_PLATFORM_ENDPOINT、METIS_APP_ID 和 METIS_APP_TOKEN。本地测试可以向 Client 显式传入配置。SDK 不创建厂商模型/存储客户端，也不隐藏重试。

依赖和 endpoint 返回字段会转换为 Python 风格：依赖使用 app_id、requested_version、 resolved_version、package_sha256、direct、available、resolution_error、app_type 和 web_base_path；应用应在使用可选依赖前检查 available。

开发

python -m pytest
python -m build

许可证

Apache-2.0，见 LICENSE。