---
title: "Powers API 参考文档"
description: "鉴权、权限范围、原生操作与结构，以及只读 OpenAPI 参考。"
image: "https://docs.sinecloud.dev/opengraph.png"
---

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

# Powers API 参考文档

<p className="api-reference-endpoint"><span>基础 URL</span><code>{"https://sinecloud.dev/api/powers/v1"}</code></p>

<div className="api-reference-actions">

[打开控制台](https://sinecloud.dev/zh-CN/dashboard?tab=powers) · [创建 API 密钥](/zh-CN/api-keys/) · [查看所有 API](/zh-CN/api-reference/)

<a href="/api/openapi/index.json" download="sinecloud-api-index.json">下载 API 索引</a>

</div>

## 首次调用前

在控制台选择组织、准备资源，并创建具有所需产品权限范围的组织 API Key。每次调用都会检查当前权限、资源访问权限、预算和可用资金。

选择可用端点，检查当前版本和输入结构。接口目录涵盖端点发现、组织连接、工具执行和持久化任务恢复。托管执行包含 `endpointId`、`expectedEndpointRevision` 和 `input`；原生执行还需选择组织拥有的连接，也可显式指定绑定。请保留原生结果及状态格式。

使用各接口 `x-sinecloud-scopes` 列出的 Cloud 权限，原生权限名称描述运行时能力。修改连接需要 `connectionWrite` 和未限制项目的组织级密钥；BYOK 凭据在控制台添加。恢复结果不明确的调用时，请重用原始 `Idempotency-Key`、版本和完整输入。HTTP 成功并不代表任务执行成功。

## 组织密钥鉴权与基础 URL

产品 API 的生产源地址是 `https://sinecloud.dev`，不是文档站点。路径前缀为 `/api/powers/v1`。请使用接口注明的完整路径，并将资源 ID、模型与端点版本替换为实际值。

```http
Authorization: Bearer $SINECLOUD_API_KEY
```

将 SINECLOUD_API_KEY 设置为你自己的环境变量值，切勿使用平台服务凭据。各接口的 `x-sinecloud-scopes` 会注明所需的权限范围。


此文档为只读参考，请在控制台或自己的客户端中发起请求。浏览文档不会创建密钥、启动执行或产生执行费用。请保留请求 ID 和执行回执；连接中断不会取消任务，再次提交前请按接口说明恢复并确认状态。

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