Authentication
Account session. Session/administrative writes are not executed in the public Playground.
Endpoint
curl --request POST 'https://api.oneaster.ai/core/v1/token-estimate' \ --header 'Authorization: Bearer '"$ONEASTER_SESSION_TOKEN" \ --header 'Content-Type: application/json' \ --data "$REQUEST_BODY_JSON"
Parameters
—
Request JSON Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"model": {
"type": "string"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"system",
"user",
"assistant"
]
},
"content": {
"type": "string"
}
},
"required": [
"role",
"content"
]
},
"minItems": 1,
"maxItems": 128
},
"max_tokens": {
"type": "integer",
"minimum": 1,
"maximum": 65536
},
"stream": {
"type": "boolean"
},
"temperature": {
"type": "number",
"minimum": 0,
"maximum": 2
}
},
"required": [
"model",
"messages",
"max_tokens"
]
}
Responses
200
模型输入预估与预留报价；无上游调用、无资金变动
{
"application/json": {
"schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"success": {
"const": true
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"model": {
"type": "string"
},
"price_version": {
"type": "integer",
"minimum": 0
},
"metering": {
"type": "object",
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"model_limit",
"utf8_bytes",
"cl100k_base",
"o200k_base"
]
},
"margin_bps": {
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"extra_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 65536
}
},
"required": [
"mode",
"margin_bps",
"extra_tokens"
]
},
"estimated_input_tokens": {
"type": "integer",
"minimum": 0
},
"reserved_input_tokens": {
"type": "integer",
"minimum": 0
},
"byte_fallback": {
"type": "boolean"
},
"output_limit": {
"type": "integer",
"minimum": 0
},
"reservation_micro": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "整数账务单位；1 积分 = 10000 单位，1 USD = 100 积分。前端用 BigInt。"
},
"currency": {
"const": "CREDITS"
},
"micro_per_credit": {
"const": 10000
},
"provisional": {
"const": true
}
},
"required": [
"model",
"price_version",
"metering",
"estimated_input_tokens",
"reserved_input_tokens",
"byte_fallback",
"output_limit",
"reservation_micro",
"currency",
"micro_per_credit",
"provisional"
]
}
},
"required": [
"success",
"data"
]
}
}
}
default
错误代码见 core-api.md；供应商/数据库错误已隐藏。
{
"application/json": {
"schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"success": {
"const": false
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"type": {
"const": "oneaster_error"
}
},
"required": [
"code",
"message",
"type"
]
},
"data": {
"type": "null"
}
},
"required": [
"success",
"error",
"data"
]
}
}
}