Authentication
Administrator. Session/administrative writes are not executed in the public Playground.
Endpoint
curl --request GET 'https://api.oneaster.ai/core/v1/admin/task-insights' \ --header 'Authorization: Bearer '"$ONEASTER_SESSION_TOKEN"
Parameters
- page (query, Optional): {"type":"integer","minimum":1,"maximum":1000000,"default":1}
- size (query, Optional): {"type":"integer","minimum":1,"maximum":100,"default":20}
- from (query, Optional): {"type":"string","format":"date-time"} 包含from，不包含to；UTC、最多微秒精度，默认最近30天、最长366天。
- to (query, Optional): {"type":"string","format":"date-time"} 包含from，不包含to；UTC、最多微秒精度，默认最近30天、最长366天。
- user_id (query, Optional): {"type":"string","pattern":"^[0-9]+$"}
- key_id (query, Optional): {"type":"string","pattern":"^[0-9]+$"}
- provider_id (query, Optional): {"type":"string","pattern":"^[0-9]+$"}
- model (query, Optional): {"type":"string","minLength":1,"maxLength":200}
- upstream_model (query, Optional): {"type":"string","minLength":1,"maxLength":200}
- kind (query, Optional): {"enum":["image","video"]}
- input_mode (query, Optional): {"enum":["text_to_image","text_to_video","image_to_video"]}
- state (query, Optional): {"enum":["queued","submitting","submitted","running","success","failed","rejected","unknown"]}
- billing_state (query, Optional): {"enum":["reserved","settled","released"]}
- cost_status (query, Optional): {"enum":["reported","unreported","invalid_evidence"]}
- resolution (query, Optional): {"enum":["480p","720p","1080p"]}
- duration (query, Optional): {"enum":[5,10]}
- issue (query, Optional): {"enum":["unresolved","cost_mismatch","nonzero_failure","invalid_evidence","unreported_terminal"]}
Responses
200
持久化图片/视频采购成本与终态健康汇总、规格分组分页
{
"application/json": {
"schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"success": {
"const": true
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"from": {
"type": "string",
"format": "date-time"
},
"to": {
"type": "string",
"format": "date-time"
},
"sampled_at": {
"type": "string",
"format": "date-time"
},
"timezone": {
"const": "UTC"
},
"attribution": {
"const": "request_created_at"
},
"scope": {
"const": "persisted_core_image_video_tasks"
},
"health_basis": {
"const": "validated_terminal_task_evidence"
},
"paid_probes": {
"const": false
},
"supplier_cost_unit": {
"const": "kie_credit"
},
"supplier_cost_scope": {
"const": "kie_tasks_only"
},
"currency": {
"const": "CREDITS"
},
"micro_per_credit": {
"const": 10000
},
"summary": {
"type": "object",
"additionalProperties": false,
"properties": {
"task_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"estimated_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unestimated_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"reported_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unreported_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"invalid_evidence_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"zero_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"cost_mismatch_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"nonzero_failure_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"supplier_success_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"supplier_failure_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"terminal_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"nonterminal_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"queued_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unknown_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unresolved_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"rejected_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"pending_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"settled_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"released_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"expected_supplier_credits": {
"type": "string",
"pattern": "^[0-9]+([.][0-9]+)?$",
"description": "筛选任务中已知的KIE原采购报价合计，含未发送任务；不是实际支出，MiniMax不计入。结合estimated_cost_count/unestimated_cost_count解读。"
},
"reported_supplier_credits": {
"type": "string",
"pattern": "^[0-9]+([.][0-9]+)?$",
"description": "仅有效身份/终态/费用证据的已报告合计，含已核账失败；缺失不视为零。"
},
"charge_micro": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "整数账务单位；1 积分 = 10000 单位，1 USD = 100 积分。前端用 BigInt。"
},
"held_micro": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "整数账务单位；1 积分 = 10000 单位，1 USD = 100 积分。前端用 BigInt。"
},
"terminal_success_rate_bps": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "有效终态成功数/有效终态数，四舍五入至基点；无终态为null，不代表实时渠道健康。"
},
{
"type": "null"
}
]
}
},
"required": [
"task_count",
"estimated_cost_count",
"unestimated_cost_count",
"reported_cost_count",
"unreported_cost_count",
"invalid_evidence_count",
"zero_cost_count",
"cost_mismatch_count",
"nonzero_failure_count",
"supplier_success_count",
"supplier_failure_count",
"terminal_count",
"nonterminal_count",
"queued_count",
"unknown_count",
"unresolved_count",
"rejected_count",
"pending_count",
"settled_count",
"released_count",
"expected_supplier_credits",
"reported_supplier_credits",
"charge_micro",
"held_micro",
"terminal_success_rate_bps"
]
},
"groups": {
"type": "object",
"additionalProperties": false,
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"provider_id": {
"type": "string",
"pattern": "^[0-9]+$"
},
"model": {
"type": "string"
},
"upstream_model": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video"
]
},
"resolution": {
"anyOf": [
{
"enum": [
"480p",
"720p",
"1080p"
]
},
{
"type": "null"
}
]
},
"duration": {
"anyOf": [
{
"enum": [
5,
10
]
},
{
"type": "null"
}
]
},
"input_mode": {
"enum": [
"text_to_image",
"text_to_video",
"image_to_video"
]
},
"task_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"estimated_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unestimated_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"reported_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unreported_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"invalid_evidence_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"zero_cost_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"cost_mismatch_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"nonzero_failure_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"supplier_success_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"supplier_failure_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"terminal_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"nonterminal_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"queued_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unknown_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"unresolved_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"rejected_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"pending_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"settled_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"released_count": {
"type": "string",
"pattern": "^[0-9]+$"
},
"expected_supplier_credits": {
"type": "string",
"pattern": "^[0-9]+([.][0-9]+)?$",
"description": "筛选任务中已知的KIE原采购报价合计，含未发送任务；不是实际支出，MiniMax不计入。结合estimated_cost_count/unestimated_cost_count解读。"
},
"reported_supplier_credits": {
"type": "string",
"pattern": "^[0-9]+([.][0-9]+)?$",
"description": "仅有效身份/终态/费用证据的已报告合计，含已核账失败；缺失不视为零。"
},
"charge_micro": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "整数账务单位；1 积分 = 10000 单位，1 USD = 100 积分。前端用 BigInt。"
},
"held_micro": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "整数账务单位；1 积分 = 10000 单位，1 USD = 100 积分。前端用 BigInt。"
},
"terminal_success_rate_bps": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "有效终态成功数/有效终态数，四舍五入至基点；无终态为null，不代表实时渠道健康。"
},
{
"type": "null"
}
]
}
},
"required": [
"provider_id",
"model",
"upstream_model",
"kind",
"resolution",
"duration",
"input_mode",
"task_count",
"estimated_cost_count",
"unestimated_cost_count",
"reported_cost_count",
"unreported_cost_count",
"invalid_evidence_count",
"zero_cost_count",
"cost_mismatch_count",
"nonzero_failure_count",
"supplier_success_count",
"supplier_failure_count",
"terminal_count",
"nonterminal_count",
"queued_count",
"unknown_count",
"unresolved_count",
"rejected_count",
"pending_count",
"settled_count",
"released_count",
"expected_supplier_credits",
"reported_supplier_credits",
"charge_micro",
"held_micro",
"terminal_success_rate_bps"
]
}
},
"total": {
"type": "string",
"pattern": "^[0-9]+$"
},
"page": {
"type": "integer",
"minimum": 0
},
"size": {
"type": "integer",
"minimum": 0
}
},
"required": [
"items",
"total",
"page",
"size"
]
}
},
"required": [
"from",
"to",
"sampled_at",
"timezone",
"attribution",
"scope",
"health_basis",
"paid_probes",
"supplier_cost_unit",
"supplier_cost_scope",
"currency",
"micro_per_credit",
"summary",
"groups"
]
}
},
"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"
]
}
}
}