认证与账号
大多数用户不需要先创建、复制或管理 API key。让 Agent 检查登录状态；需要认证时，它会启动设备授权，并给你 NoxInfluencer 官方链接和用户授权码。你可以在任意浏览器完成授权。
新用户登录路径
安装 Skill 后，直接告诉 Agent：
帮我开始使用 NoxInfluencer Skill。请检查登录状态，并在需要时引导我注册或登录。
正常流程是：
- Agent 检查 NoxInfluencer CLI 和认证状态。
- 如果尚未登录，Agent 启动设备授权，并给你官方链接和 user code。
- 你在任意浏览器打开链接，登录已有账号或创建新账号，然后批准访问。
- CLI 创建或复用访问凭证，并保存到本地配置；你不需要通过聊天复制 API key。
- Agent 检查可用额度，然后继续执行你的第一个任务。
新账号注册后可获得一次性 30 Credits 免费额度，无需绑定信用卡。当前余额和套餐状态可在 Skills Dashboard 查看。
手动启动设备授权
只有 Agent 没有自动触发时，才需要手动运行：
noxinfluencer login
CLI 会显示授权链接和 user code，在条件允许时打开链接，并等待你批准访问。在 Agent、容器或远程终端中，应把用户授权和轮询拆成两步：
noxinfluencer login start --json
noxinfluencer login wait <login_id>
如需只检查一次待处理登录而不持续等待，可以使用：
noxinfluencer login status <login_id>
login start 不会打开浏览器，也不会输出秘密 device code。Agent 可以向你提供 verification_uri_complete 和 user_code，但不能暴露 device_code。只有本机 loopback callback 可用时，才使用可选的 noxinfluencer login --browser 路径。
需要中文引导链接和提示时：
noxinfluencer --lang zh login
英文账号入口是 NoxInfluencer Skills Dashboard。
API key 仅作为兜底
设备授权不可用，或你的 Agent 环境由管理员统一托管凭证时，才需要手动配置 API key。
- 从官方 Skills Dashboard 获取 key
- 使用
noxinfluencer auth --key-stdin安全写入，不要把 key 作为命令参数 - 已托管凭证的环境可以使用
NOXINFLUENCER_API_KEY - 不要把 API key 放进聊天消息、日志、截图、工单正文或可共享文件
账号、权限和 Credits
一次调用能否执行，可能同时取决于：
- 账号套餐是否包含该能力
- 对应 Tool 是否标记为已开放或 Beta
- 当前 Credits 是否足够
- 对应 NoxInfluencer 底层服务配额或权限是否可用
官网使用 Credits 表达套餐和消耗；CLI 使用 quota 显示当前余额和可用状态。部分动作还会检查底层服务配额，因此有剩余 Credits 不一定代表所有能力都可执行。
达人搜索和相似达人当前按实际返回的达人数计费。执行大范围任务前，可以让 Agent 检查当前单价和近期用量：
noxinfluencer quota
noxinfluencer pricing tools --charged-only
noxinfluencer quota usage --days 7
详细说明见 Credits 与配额。
Skill、Remote MCP 与 Rest API
- 本文默认介绍的是 Skill / CLI 登录路径
- Remote MCP 是面向 MCP 客户端的只读接入面，使用自己的 API key 或 OAuth connector 配置，见 Remote MCP
- Rest API 从
/api-service和当前 Theneo 文档进入，使用 Rest API Credit，不与 Skill 的 Credits 混用
登录失败时
让 Agent 依次检查：
noxinfluencer doctornoxinfluencer loginnoxinfluencer quota
远程 Agent 流程中的授权如果过期，请重新运行 login start --json，再用新的 login_id 等待结果。不要复用已过期登录，也不要要求 Agent 输出秘密 device code。
