{"openapi":"3.1.0","info":{"title":"JC Future E-Token Planning API","version":"1.0.0","description":"查询具身目录、生成确定性任务计划并估算演示 E-Token 用量。接口不执行机器人任务，也不产生扣费。"},"servers":[{"url":"https://jcfuture.ai.jcfuture.ai"}],"security":[],"paths":{"/api/etoken/catalog":{"get":{"operationId":"getETokenCatalog","summary":"查询作业中心、机器人本体与作业能力目录","parameters":[{"name":"centerId","in":"query","required":false,"schema":{"type":"string","enum":["beijing-yizhuang","shenzhen-longgang"]}}],"responses":{"200":{"description":"目录数据"},"400":{"description":"无效中心"}}}},"/api/etoken/plan":{"post":{"operationId":"planETokenTask","summary":"解析自然语言任务并生成结构化计划及用量估算","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskPlanRequest"},"example":{"centerId":"beijing-yizhuang","prompt":"我是服饰跨境电商厂商，我现在有 500 件待出库的 T 恤，需要你按尺码和颜色分类、折叠装袋，每袋一件，并按我提供的规则贴标。"}}}},"responses":{"200":{"description":"任务计划；无法理解时返回 clarifications"},"400":{"description":"请求格式错误"}}}},"/api/etoken/estimate":{"post":{"operationId":"estimateETokenUsage","summary":"按能力调用数量进行确定性 E-Token 试算","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateRequest"},"example":{"centerId":"beijing-yizhuang","capabilityCalls":[{"capabilityId":"pick-place","quantity":100}]}}}},"responses":{"200":{"description":"试算明细、总量及范围"},"400":{"description":"请求格式错误"}}}},"/api/etoken/openapi":{"get":{"operationId":"getETokenOpenApi","summary":"获取本 OpenAPI 描述","responses":{"200":{"description":"OpenAPI 3.1 文档"}}}}},"components":{"schemas":{"TaskPlanRequest":{"type":"object","required":["centerId","prompt"],"properties":{"centerId":{"type":"string","enum":["beijing-yizhuang","shenzhen-longgang"]},"prompt":{"type":"string"},"preferences":{"type":"object","properties":{"bodyIds":{"type":"array","items":{"type":"string"}}}}}},"EstimateRequest":{"type":"object","required":["centerId","capabilityCalls"],"properties":{"centerId":{"type":"string","enum":["beijing-yizhuang","shenzhen-longgang"]},"capabilityCalls":{"type":"array","minItems":1,"items":{"type":"object","required":["capabilityId","quantity"],"properties":{"capabilityId":{"type":"string"},"quantity":{"type":"integer","minimum":1}}}}}}}},"x-jcfuture-authentication":"无需鉴权；当前仅提供公开目录与本地试算演示。","x-jcfuture-external-model":"未配置且不需要外部模型密钥；使用确定性规则规划。"}