平台开放能力¶
本页说明 AI Studio 数据侧对外开放的程序化能力：算子 API、SQL 连接串、REST 数据源与 Webhook 等。
文档仓库当前未提供知识库、智能体、工作流等业务 REST 的完整 OpenAPI 目录。本页为能力索引与调用形态说明；具体端点与字段以产品发布说明、控制台接口示例或后续 OpenAPI 为准。操作步骤见开发；连接器字段见连接器。
能力一览¶
能力 |
方向 |
用途 |
鉴权与计费 |
|---|---|---|---|
调用处理能力 |
解析、分段、嵌入、信息提取等 |
默认可使用 Genesis API Key 与 Credit；亦可配置 OAuth 2.0 或公开访问 |
|
外部直连查询 Catalog |
BI、客户端、第三方程序查询 |
Catalog 连接凭证；查询消耗查询型计算资源 |
|
入仓 / 出仓 |
第三方 REST 载入；处理结果或事件推送 |
连接器凭证或接收端验签 |
上述数据能力均归属工作区 Catalog 与计算资源范围。
算子 API¶
将系统算子或自定义算子发布为 REST 服务。发布后可对外调用，并可作为智能体工具使用。发布与配置在 Catalog 中完成。
调用约定¶
项 |
说明 |
|---|---|
调用模式 |
同步：请求入参后返回结果；算子层不提供独立异步作业模型 |
长任务 |
编排为工作流，通过作业状态或 Webhook 获取结果 |
入参 |
对应算子的输入与参数签名（名称、类型、是否必填、默认值）；输入来源以发布配置为准 |
鉴权与运行¶
项 |
说明 |
|---|---|
鉴权 |
API Key（默认，可复用 Genesis 密钥）、OAuth 2.0、公开访问 |
计费与限流 |
使用 API Key 时通常与 Genesis 密钥及 Credit 共用策略 |
运行资源 |
模型类算子可走模型 API；其它算子绑定计算资源 |
运行配置 |
超时、最大并发、调用频率等，可在服务详情中调整 |
请求示例¶
POST https://<OPERATOR_ENDPOINT>
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"input": "..."
}
服务地址、入参与出参因算子而异，以该算子详情页「API 服务」中的说明为准。
相关操作¶
发布、版本与试用：指南 · Catalog / 数据处理
系统算子清单：系统算子库
SQL 连接串¶
提供标准数据库连接信息，供支持 MySQL 协议的客户端、BI 工具与驱动程序直连查询 Catalog 中的库表。
要素¶
要素 |
说明 |
|---|---|
host / port |
查询服务地址与端口 |
库 / 表路径 |
目标 database（及表） |
鉴权 |
用户与密码或等价凭证 |
具体取值以 Catalog 中生成的真实连接串为准。
连接示例¶
mysql -h <HOST> -P <PORT> -u <USER> -p
host=<HOST> port=<PORT> user=<USER> password=<PASSWORD> database=<DATABASE>
适用场景¶
适用 |
不适用 |
|---|---|
报表直连、交互式探索、按需取数 |
高频、大并发的程序化数据消费（宜通过工作流落表或算子 API） |
SQL 查询通常按查询型计算资源的在线时长计费，不以「按次 SQL API」单独计价（以计费说明为准）。语法见SQL 参考。
REST 数据源与 Webhook¶
REST 数据源¶
通过连接器类型 REST API 或 GraphQL 接入第三方 HTTP 接口，并由载入任务写入 Catalog。连接器字段见连接器。
配置项 |
说明 |
|---|---|
Base URL / GraphQL 端点 |
服务根地址 |
认证方式 |
API Key、Bearer Token、OAuth 2.0 或无认证 |
超时、分页、数据路径、默认请求头 |
读取策略 |
具体路径、方法与查询参数在载入任务中配置。
Webhook¶
场景 |
说明 |
|---|---|
数据导出 |
将 Catalog 中的处理结果以 HTTP 推送至外部接收端 |
平台通知 |
作业、告警等事件回调（以产品是否开放为准） |
接收端应校验请求来源（签名、IP 允许列表等）。签名算法与负载字段以实际接口为准；接收端实现见开发相关集成说明。
数据方向对照¶
能力 |
方向 |
|---|---|
REST 数据源 |
外部 → MOI |
Webhook 导出 |
MOI → 外部 |
SQL 连接串 |
外部直连查询 Catalog |
算子 API |
调用平台处理能力 |
暂未收录的接口¶
以下能力可能在控制台或内测环境中存在，本参考暂不提供逐接口说明（尚无稳定 OpenAPI）：
知识库管理接口
智能体、技能、工具管理接口
工作流触发与作业查询接口
应用托管对外接口
待官方规范或发布说明补齐后再行收录。集成前请以控制台开放接口说明与支持渠道为准。