跳转到内容
tansr 资料站

自建裁决人档(modelHandle 须作用域可解析;每户上限 8;写后 bundle 失效;带 x-tansr-org 头 = org 扩容录入,owner/admin——组织扩容面;tier 越平台天花板 400 validation_failed 携 ceiling)

POST
/v1/adjudicators
curl --request POST \
  --url https://api.tansr.com/v1/adjudicators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "modelHandle": "example", "budgets": { "maxRounds": 1, "maxUsd": "example", "maxCny": "example", "callBudget": 1 }, "escalation": { "mode": "parent" }, "tier": "low" }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
x-tansr-org
string

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

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
required
string
>= 1 characters <= 64 characters
modelHandle
required

须在本户可解析目录内(handle/alias/上游 modelId 同网关路由径),否则 400 validation_failed

string
>= 1 characters <= 128 characters
budgets
object
maxRounds
integer
>= 1 <= 10
maxUsd

预算上限,DECIMAL 字符串(金额纪律,禁浮点)

string
/^\d+(\.\d{1,6})?$/
maxCny

会话内裁决成本上限的 CNY 位,DECIMAL 字符串(与 maxUsd 同源校验;双币一等公民,恒不折算)

string
/^\d+(\.\d{1,6})?$/
callBudget

每会话裁决咨询预算(次);M-04 档级覆写,缺席回落 org 缺省,皆缺席 = sdk 缺省 200

integer
>= 1 <= 10000
escalation
object
mode
required
Any of:
string
Allowed value: parent
tier
Any of:
string
Allowed value: low

Responses

Section titled “Responses”

201

Section titled “201”

已建

Media typeapplication/json
object
adjudicator
required
object
id
required
string
scope
required
Any of:
string
Allowed value: platform
name
required
string
modelHandle
required
Any of:
string
budgets
required
object
escalation
required
object
editable
required

本户自建档 true;platform 缺省只读 false

boolean
tier
required
Any of:
string
Allowed value: low
evaluation
required
object
status
required
Any of:
string
Allowed value: evaluated
reportRef

评估报告回挂(INV-5 产出引用)

string
fingerprint

评估时点协议指纹(D8 漂移判定基线)

string
evaluatedAt

ISO 8601

string
byProtocol
object
coding
object
fingerprint
required

该协议最近一次报告的协议指纹

string
reportRef
required

该报告 publicId(GET …/evaluation-reports 可解引用;与 evaluation.reportRef 同口径)

string
evaluatedAt
required

ISO 8601

string
app
object
fingerprint
required

该协议最近一次报告的协议指纹

string
reportRef
required

该报告 publicId(GET …/evaluation-reports 可解引用;与 evaluation.reportRef 同口径)

string
evaluatedAt
required

ISO 8601

string
forceTrustAskedAt
required
Any of:
string
updatedAt
required
string
Example
{
  "adjudicator": {
    "scope": "platform",
    "tier": "low",
    "evaluation": {
      "status": "evaluated"
    }
  }
}

400

Section titled “400”

Validation_failed(modelHandle 不可解析 / tier 越天花板)/ limit_exceeded(每户 8)

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}