跳转到内容
tansr 资料站

逐笔成本演算——组织/用户版(演算页):**仅销售口径投影**,id = requestId,归属校验非本 owner 恒 404(不泄露存在性);响应 = 四象限量 + dims 长尾维 + cost{stored,recomputed,match,listCost?,discount?}(价格快照四列 × 量重算 = 牌价 ≡ list_cost ?? cost 即销售价恒等式,用户可自证账单;协议价行 recomputed 对牌价快照 list_cost 比对并携 listCost/discount 两键 =「牌价 − 优惠 = 实收」,牌价行无两键零漂移)+ price 四列(缓存象限含回落语义 fallback 标注)+ breakdown 四象限分解行 + saved 三分量(readSaved/writePremium/netSaved);快照缺席存量行/byok/client 径如实 degraded:"no_price_snapshot" 不猜不造;estimated 行如实冠估算;可见性红线:采购成本/采购结构 spec/指纹/缺价记名/毛利恒不出面

GET
/v1/usage-events/{id}/cost-explain

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

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

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

Responses

Section titled “Responses”

200

Section titled “200”

销售口径演算

Media typeapplication/json
object
key
additional properties
any
Examplegenerated
{}

404

Section titled “404”

Not_found(不存在/非本 owner,不泄露存在性)

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"
  }
}