切换主题
能力注册
应用能力操作需要 APP_ADMIN 或 PLATFORM_ADMIN；公共模型与全局绑定需要平台管理员。注册正文是 id/version/definition，更新正文直接是 definition。单资源发布需先发布依赖；批次发布可在一个事务内发布整条依赖链。
支持的 kind：agents、tools、knowledge、ui-capabilities、model-providers、models、model-bindings、model-profiles。版本为三段稳定语义版本。更新草稿和替换默认入口要求带双引号的 If-Match。已发布定义不可变；撤销后不能再次发布。公共模型草稿使用 POST 与 If-Match 更新，没有单独 PUT 路由。
GET /v1/apps/{app}/
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | 数组：Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
| If-Match | header | 否 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：Registration。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
GET /v1/apps/{app}/{kind}/{resourceId}/versions/
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
PUT /v1/apps/{app}/{kind}/{resourceId}/versions/
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
| If-Match | header | 否 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：Definition。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/{kind}/{resourceId}/versions/{version}/publish
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/{kind}/{resourceId}/versions/{version}/revoke
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| kind | path | 是 | string；— |
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
GET /v1/model-providers
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | 数组：Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/model-providers
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| If-Match | header | 否 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：Registration。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/model-providers/{resourceId}/versions/{version}/publish
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/model-providers/{resourceId}/versions/{version}/revoke
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
GET /v1/models
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | 数组：Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/models
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| If-Match | header | 否 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：Registration。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/models/{resourceId}/versions/{version}/publish
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/models/{resourceId}/versions/{version}/revoke
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| resourceId | path | 是 | string；— |
| version | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | Registry |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 410 | application/json | Error |
| 412 | application/json | Error |
| 413 | application/json | Error |
| 429 | application/json | Error |
| 500 | application/json | Error |
| 502 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/release-plans
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：ReleaseRequest。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | ReleasePlan |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 412 | application/json | Error |
| 500 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/releases
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| If-Match | header | 是 | string；预检返回的应用修订，带双引号。 |
| X-Release-Plan | header | 是 | string；pattern: "^[a-f0-9]{64}$" |
| Idempotency-Key | header | 是 | string；pattern: "^[a-zA-Z0-9_.:-]{1,128}$" |
请求正文
Content-Type：application/json；正文必填。
类型：ReleaseRequest。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | ReleaseRecord |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 412 | application/json | Error |
| 500 | application/json | Error |
| 503 | application/json | Error |
GET /v1/apps/{app}/releases
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| limit | query | 否 | integer；default: 50；minimum: 1；maximum: 100 |
| offset | query | 否 | integer；default: 0；minimum: 0；maximum: 1000000 |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | ReleasePage |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 412 | application/json | Error |
| 500 | application/json | Error |
| 503 | application/json | Error |
GET /v1/apps/{app}/releases/
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
| releaseId | path | 是 | string；— |
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | ReleaseRecord |
| 400 | application/json | Error |
| 401 | application/json | Error |
| 403 | application/json | Error |
| 404 | application/json | Error |
| 409 | application/json | Error |
| 412 | application/json | Error |
| 500 | application/json | Error |
| 503 | application/json | Error |
POST /v1/apps/{app}/model-compatibility
参数
| 名称 | 位置 | 必填 | 类型与约束 |
|---|---|---|---|
| app | path | 是 | string；— |
请求正文
Content-Type：application/json；正文必填。
类型：Ref。—
响应
| HTTP | 响应类型 | 数据结构 |
|---|---|---|
| 200 | application/json | ModelCompatibilityReport |
| 其他错误 | application/json | Error |