---
title: "Sine Powers：工具调用与恢复"
description: "查找工具 Endpoint、按 schema 填写输入，选择平台执行或自有供应商账户，并恢复结果不确定的调用，避免重复执行。"
image: "https://docs.sinecloud.dev/opengraph.png"
---

> 完整文档索引： https://docs.sinecloud.dev/zh-CN/llms.txt

# Sine Powers：工具调用与恢复

Sine Powers 是独立的工具目录和执行入口。选择组织后即可进入，无需创建项目、准备实例或配置自己的供应商账号。工具的可用性、价格、授权和实际执行能力仍需分别满足。

## 执行第一个工具

1. 登录 [Console](https://sinecloud.dev/zh-CN/dashboard)，选择组织并打开 **Powers**。
2. 在 **工具目录** 搜索工具，打开工具端点（Endpoint）详情，阅读说明、版本、输入输出契约及运行时支持状态。
3. 选择 **调用 Endpoint** 进入调试，默认使用平台执行。
4. 按工具的实际 schema 填写必需参数，核对输入 JSON、价格、可用余额和可选项目归属。
5. 明确执行，在结果区和 **调用记录** 中核对保存的状态、结果与财务详情。

平台执行不需要提交供应商密钥。某个工具出现在目录中，不代表已经有可用执行路由或适用价格；不支持的工具仍可保留在目录并显示原因。

## 正确填写输入

输入沿用工具契约，按需要提供 `body`、`queryParams`、`pathParams`。字段名称和结构取决于具体 Endpoint，不存在适用于所有工具的通用请求体。`pathParams` 中的值必须是字符串，完整请求最多 64 KiB。

支持对象字段 schema 的工具可使用页面中的输入助手。助手仅填入契约明确声明的默认值；数组和对象使用 JSON。填入后仍应审阅最终输入，复杂字段可以直接编辑 JSON。

[项目](/zh-CN/organizations/)是可选的调用归属，不会创建独立凭据目录。Endpoint ID 可能包含 `#` 或 `/`；程序接入时必须对整个 ID 编码，不能把一部分当作 URL 片段。

## 选择自己的供应商账户

要使用自己的供应商账户与凭据，打开 **高级 BYOK**（自有密钥）。该区域向组织所有者和管理员开放，并受连接写入权限限制。

1. 添加当前运行时支持的原厂供应商连接，按表单填写账户标识和凭据。
2. 保存后仅显示连接元数据，明文凭据不再返回。保存成功不证明供应商一定接受凭据。
3. 回到工具调试页，展开 **高级设置：使用自己的账户**，明确选择兼容的组织账户。
4. 核对费用和输入后执行；回到默认选项才会改用平台执行。

组织 BYOK 不支持自行配置聚合提供商。自有账户调用失败时不会自动切换到平台付费路径或其他供应商。凭据停用可以恢复，撤销不可恢复；更换账户使用新的连接身份。

BYOK 的供应商账单和 Cloud 平台费分开核对。选择自有账户不等于所有费用为零，执行前以页面显示的价格与[组织账务](/zh-CN/billing/)为准。

## 恢复不确定的调用

`ACCEPTED`、`RUNNING`、`UNKNOWN` 都不表示成功。工具可能修改外部数据，因此不要新建请求来“确认”原请求是否成功。

- 已有 Run ID：查询原调用记录或使用 **恢复原请求**。
- 尚无 Run ID：先检查调用历史；需要恢复提交时，沿用原请求标识、输入、Endpoint 版本、项目和原先选择的自有账户。
- 页面刷新后缺少输入：补回完全相同的原始输入。恢复标识不会保存工具输入、凭据或结果正文。

离开页面不取消服务器执行。只有明确开始另一项工作时才选择“新调用”，并考虑旧任务仍可能运行。运行结果和财务结算是不同状态，应分别查看。

## 程序接入与用量

打开 **API 与 CLI**，使用选中 Endpoint 的实际版本和输入契约生成示例。默认平台示例不需要实例参数或供应商连接标识。创建 [API 密钥](/zh-CN/api-keys/) 时，执行授予 `toolRun`，读取目录授予 `catalogRead`，读取调用记录授予 `runRead`；按需要分别增加权限。

**调用记录**提供当前用户有权查看的组织记录。项目选择不切割该历史目录；按项目核对 Cloud 用量应进入组织 **用量** 页。工具次数、时长和原生计量保持独立，缺失值不视为零，当前页条数也不是总用量。

来源: https://docs.sinecloud.dev/zh-CN/products/powers/index.mdx