用户模型池只读查询：账户创建时原子快照，GET不补种；缺档为空。selected保留顺序及失效引用，inherited:false，initialization说明来源，unavailable说明原因。impactCatalogId可按需查询一个已存引用在本scope的影响。

GET

/v1/model-selection

curl --request GET \
  --url https://api.tansr.com/v1/model-selection \
  --header 'Authorization: Bearer <token>'

Authorizations

• bearerAuth

Parameters

Header Parameters

x-tansr-org

string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

Query Parameters

impactCatalogId

string

<= 64 characters

Responses

200

选择集与可添加全集

Media typeapplication/json

object

selected

required

创建时初始化的私有模型池；GET不写入。已有档案（含空数组与失效引用）原样回读，实际消费仍受当前许可链约束。

Array<string>

inherited

required

恒false；缺少初始化档案时为空集，查询不创建配置或恢复动态继承。

boolean

revision

required

当前选择状态的不可解读内容指纹；管理写入以 expectedRevision 防止旧页面覆盖新选择，并非递增序号。

string

/^[a-f0-9]{64}$/

initialization

required

Any of:

null

null

object

object

version

required

number

Allowed value: 1

source

required

Any of:

string

string

Allowed value: starter

string

string

Allowed value: legacy

string

string

Allowed value: owner

initializedAt

required

string

sourceRevision

required

string

/^[a-f0-9]{64}$/

unavailable

required

Array<object>

object

catalogId

required

string

>= 1 characters <= 64 characters

handle

required

Any of:

string

string

null

null

displayName

required

Any of:

string

string

null

null

reason

required

Any of:

string

string

Allowed value: catalog_missing

string

string

Allowed value: official_permission_removed

string

string

Allowed value: official_permission_disabled

string

string

Allowed value: starter_pool_removed

string

string

Allowed value: owner_pool_removed

string

string

Allowed value: application_pool_removed

string

string

Allowed value: model_unservable

string

string

Allowed value: role_unsupported

impact

object

catalogId

required

string

>= 1 characters <= 64 characters

ownerCount

required

integer

<= 9007199254740991

applicationCount

required

integer

<= 9007199254740991

defaultCount

required

integer

<= 9007199254740991

available

required

可添加全集 = 本 owner 视角下可服务的 platform 目录(自定义端点/BYOK 不在册、不受选择集约束)

Array<object>

object

freeUsage

平台独立免费政策的只读服务器状态；用户不能修改或延长期限。

object

enabled

required

boolean

validFrom

required

Any of:

string

string format: date-time

null

null

validUntil

required

Any of:

string

string format: date-time

null

null

status

required

Any of:

string

string

Allowed value: disabled

string

string

Allowed value: scheduled

string

string

Allowed value: active

string

string

Allowed value: expired

evaluatedAt

required

string format: date-time

catalogId

required

目录 public id(选择集引用键)

string

handle

required

CLI 侧模型引用名(tansr/)

string

displayName

required

string

kind

required

模型形态(三级过滤:类别;available 与 bundle 可服务性谓词同源,现恒 chat)

string

family

required

模型族(三级过滤:厂商;model_catalog.family 结构化列)

string

manufacturer

required

Any of:

string

string

null

null

tags

required

Profile 标签(三级过滤:标签;无 Profile 回 [])

Array<string>

contextWindow

required

Any of:

integer

integer

null

null

pricing

required

Any of:

object

object

inPerMillion

required

Exact nonnegative sale unit rate; up to 12 integer and 30 effective fractional digits. Wallets and settled amounts remain Money6 (at most 6 fractional digits).

string

<= 43 characters /^\d{1,12}(\.\d{1,30}0*)?$(?![\s\S])/

outPerMillion

required

Exact nonnegative sale unit rate; up to 12 integer and 30 effective fractional digits. Wallets and settled amounts remain Money6 (at most 6 fractional digits).

string

<= 43 characters /^\d{1,12}(\.\d{1,30}0*)?$(?![\s\S])/

cacheReadPerMillion

required

Exact nonnegative sale unit rate; up to 12 integer and 30 effective fractional digits. Wallets and settled amounts remain Money6 (at most 6 fractional digits).

string

<= 43 characters /^\d{1,12}(\.\d{1,30}0*)?$(?![\s\S])/

cacheWritePerMillion

required

Exact nonnegative sale unit rate; up to 12 integer and 30 effective fractional digits. Wallets and settled amounts remain Money6 (at most 6 fractional digits).

string

<= 43 characters /^\d{1,12}(\.\d{1,30}0*)?$(?![\s\S])/

null

null

Example

{
  "initialization": {
    "version": 1,
    "source": "starter"
  },
  "unavailable": [
    {
      "reason": "catalog_missing"
    }
  ],
  "available": [
    {
      "freeUsage": {
        "status": "disabled"
      }
    }
  ]
}

本文是否有帮助?

有帮助没帮助