{"openapi":"3.1.0","info":{"title":"MOEModels public API","version":"1.0.0","description":"Versioned model evidence, calculated checkpoint-residency lower bounds, owner-reported evaluation evidence, and deployment-validation plans. Calculated outputs are not measured performance or deployment certification.","license":{"name":"Apache-2.0","identifier":"Apache-2.0"}},"servers":[{"url":"https://moemodels.ai","description":"Public API"}],"tags":[{"name":"Registry","description":"Sourced exact-artifact records."},{"name":"Planning","description":"Deterministic calculations and validation plans."},{"name":"Evidence","description":"Owner-reported claims and normalized runs."}],"paths":{"/api/v1/registry":{"get":{"operationId":"getRegistry","tags":["Registry"],"summary":"Get the versioned model and hardware registry","responses":{"200":{"description":"A registry containing sourced facts and explicit unknowns.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Registry"}}}}}}},"/api/v1/fit":{"get":{"operationId":"calculateStaticFit","tags":["Planning"],"summary":"Calculate a checkpoint-residency lower bound","description":"Uses exact checkpoint tensor bytes and advertised accelerator memory. It does not measure runtime compatibility, KV cache, throughput, latency, or cost.","parameters":[{"name":"model","in":"query","schema":{"type":"string","default":"kimi-k3"}},{"name":"hardware","in":"query","schema":{"type":"string","default":"h200"}},{"name":"devices","in":"query","required":false,"description":"Requested accelerator count.","schema":{"type":"integer","default":8,"minimum":1,"maximum":4096}},{"name":"devicesPerNode","in":"query","required":false,"description":"Accelerators in one planning node.","schema":{"type":"integer","default":8,"minimum":1,"maximum":256}},{"name":"reserveBps","in":"query","required":false,"description":"Capacity reserve in basis points.","schema":{"type":"integer","default":1300,"minimum":0,"maximum":9999}}],"responses":{"200":{"description":"Calculated static fit with limitations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FitResponse"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/plan":{"get":{"operationId":"createDeploymentValidationPlan","tags":["Planning"],"summary":"Create a deterministic deployment-validation plan","description":"Returns a calculated static verdict and ordered evidence gates. The response contains no measured performance prediction.","parameters":[{"name":"model","in":"query","schema":{"type":"string","default":"kimi-k3"}},{"name":"hardware","in":"query","schema":{"type":"string","default":"h200"}},{"name":"devices","in":"query","required":false,"description":"Requested accelerator count.","schema":{"type":"integer","default":8,"minimum":1,"maximum":4096}},{"name":"devicesPerNode","in":"query","required":false,"description":"Accelerators in one planning node.","schema":{"type":"integer","default":8,"minimum":1,"maximum":256}},{"name":"reserveBps","in":"query","required":false,"description":"Capacity reserve in basis points.","schema":{"type":"integer","default":1300,"minimum":0,"maximum":9999}},{"name":"runtime","in":"query","schema":{"type":"string","default":"unspecified","pattern":"^[a-z0-9][a-z0-9._-]{0,63}$"}},{"name":"inputTokens","in":"query","required":false,"description":"Target input length.","schema":{"type":"integer","default":4096,"minimum":1,"maximum":10000000}},{"name":"outputTokens","in":"query","required":false,"description":"Target output length.","schema":{"type":"integer","default":1024,"minimum":1,"maximum":1000000}},{"name":"concurrency","in":"query","required":false,"description":"Simultaneous requests.","schema":{"type":"integer","default":1,"minimum":1,"maximum":100000}},{"name":"targetTtftMs","in":"query","required":false,"description":"P95 time-to-first-token target in milliseconds.","schema":{"type":"integer","default":1000,"minimum":1,"maximum":600000}},{"name":"targetInterTokenMs","in":"query","required":false,"description":"P95 inter-token target in milliseconds.","schema":{"type":"integer","default":50,"minimum":1,"maximum":60000}},{"name":"availability","in":"query","schema":{"type":"string","enum":["single","ha"],"default":"single"}}],"responses":{"200":{"description":"A versioned validation plan with explicit unknowns.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanResponse"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/evaluations":{"get":{"operationId":"listEvaluationEvidence","tags":["Evidence"],"summary":"List evaluation evidence without merging evidence classes","parameters":[{"name":"model","in":"query","schema":{"type":"string"}},{"name":"suite","in":"query","schema":{"type":"string"}},{"name":"artifactAssociation","in":"query","schema":{"type":"string","enum":["artifact_snapshot_associated","model_name_only"]}}],"responses":{"200":{"description":"Owner-reported claims, normalized runs, sources, and counts.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/InvalidInput"}}}},"/api/v1/evaluations/{id}":{"get":{"operationId":"getEvaluationEvidence","tags":["Evidence"],"summary":"Get one claim or normalized run with supporting evidence","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Evidence record, referenced sources, and raw artifacts when available.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"schemas":{"Registry":{"type":"object","required":["registryVersion","models","hardware","compatibility"],"properties":{"registryVersion":{"type":"string","const":"1.0.0"},"models":{"type":"array","items":{"type":"object","additionalProperties":true}},"hardware":{"type":"array","items":{"type":"object","additionalProperties":true}},"compatibility":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"FitResponse":{"type":"object","required":["apiVersion","registryVersion","model","hardware","input","fit"],"properties":{"apiVersion":{"type":"string","const":"v1"},"registryVersion":{"type":"string"},"fit":{"type":"object","description":"Calculated static checkpoint-residency result; never measured performance.","additionalProperties":true}},"additionalProperties":true},"PlanResponse":{"type":"object","required":["apiVersion","registryVersion","plan"],"properties":{"apiVersion":{"type":"string","const":"v1"},"registryVersion":{"type":"string"},"plan":{"type":"object","required":["schemaVersion","kind","readiness","validationGates"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"kind":{"type":"string","const":"deployment_validation_plan"},"readiness":{"type":"object","additionalProperties":true},"validationGates":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true}},"additionalProperties":true},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}},"responses":{"InvalidInput":{"description":"Invalid query input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The exact registry or evidence identity was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}