{"openapi":"3.1.1","info":{"title":"Some AI Stuff account read API","version":"1.0.0","description":"Account API key required in Authorization: Bearer for machine data; browser cookies are not accepted. Free: basic model list/detail only, with basic-field search and no provider filtering. Pro: all existing machine evidence. Usage is bounded across account keys, REST and MCP, resetting by calendar UTC month and minute. Read only; no inference or live provider requests. This contract and HTML docs are public. MCP endpoint: /mcp; manual bearer-header clients are supported. Clients that require OAuth discovery rather than supplied API-key headers are not supported by this flow. Documentation: /api/."},"servers":[{"url":"https://someaistuff.com"}],"security":[{"accountApiKey":[]}],"x-account-limits":{"free":{"requestsPerMinute":60,"requestsPerMonth":1000,"snapshotsPerMonth":0},"pro":{"requestsPerMinute":120,"requestsPerMonth":100000,"snapshotsPerMonth":30}},"x-mcp-client-setup":{"url":"https://someaistuff.com/mcp","transport":"Streamable HTTP","headers":{"Authorization":"Bearer <account API key>"},"typescriptTransportOptions":"{ requestInit: { headers: { Authorization: `Bearer ${key}` } } }","oauthDiscovery":false},"paths":{"/api/openapi.json":{"get":{"operationId":"openapi_contract","security":[],"summary":"Public machine contract; no snapshot rows are returned.","responses":{"200":{"description":"OpenAPI document"}}}},"/api/v1/models":{"get":{"operationId":"list_models","summary":"Free basic projection or Pro full records. Search canonical models and their exact aliases. Use the returned model id for prices and benchmark results.","x-required-tier":"free","x-free-query-schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search over basic model ID, name, developer, modality and capabilities only.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modality":{"type":"string","enum":["llm","image","video","audio","3d","embedding","rerank","decision"]},"developer":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"capability":{"type":"string","enum":["tools","structured-output","vision","audio-input","transcription","video-input","reasoning","prompt-cache","open-weights"]}},"additionalProperties":false},"parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modality","in":"query","required":false,"schema":{"type":"string","enum":["llm","image","video","audio","3d","embedding","rerank","decision"]}},{"name":"developer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"providerId","in":"query","required":false,"description":"Pro required.","schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"capability","in":"query","required":false,"schema":{"type":"string","enum":["tools","structured-output","vision","audio-input","transcription","video-input","reasoning","prompt-cache","open-weights"]}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"collection":{"const":"models"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BasicModel"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search over basic model ID, name, developer, modality and capabilities only.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modality":{"type":"string","enum":["llm","image","video","audio","3d","embedding","rerank","decision"]},"developer":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"capability":{"type":"string","enum":["tools","structured-output","vision","audio-input","transcription","video-input","reasoning","prompt-cache","open-weights"]}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","collection","data","pagination"],"additionalProperties":false},{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"models"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modality":{"type":"string","enum":["llm","image","video","audio","3d","embedding","rerank","decision"]},"developer":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"providerId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"capability":{"type":"string","enum":["tools","structured-output","vision","audio-input","transcription","video-input","reasoning","prompt-cache","open-weights"]}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}]}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/prices":{"get":{"operationId":"list_prices","summary":"Pro required. Read exact provider routes with billing units, configuration, conditional pricing, availability and checkedAt. Null prices are unknown, never zero. No cheapest-route ranking is inferred.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modelId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"providerId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"unit","in":"query","required":false,"schema":{"type":"string","enum":["million-tokens","image","megapixel","second","minute","hour","thousand-characters","request","generation","compute-second"]}},{"name":"available","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"prices"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modelId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"providerId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"unit":{"type":"string","enum":["million-tokens","image","megapixel","second","minute","hour","thousand-characters","request","generation","compute-second"]},"available":{"type":"boolean"}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/benchmarks":{"get":{"operationId":"list_benchmarks","summary":"Pro required. Read model-only benchmark observations with the metric definition, version, configuration, reporting provenance and separate source/evaluation clocks.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modelId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"metricId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"benchmarks"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Benchmark"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modelId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"metricId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/agent-benchmarks":{"get":{"operationId":"list_agent_benchmarks","summary":"Pro required. Read model plus agent harness results. These are not model-only scores; preserve agent name, version, reasoning effort and benchmark version.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modelId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"benchmark","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"agent-benchmarks"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AgentBenchmark"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modelId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"benchmark":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/metrics":{"get":{"operationId":"list_metrics","summary":"Pro required. List named benchmark metric definitions, units, versions and whether higher values are better.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"metrics"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Metric"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/news":{"get":{"operationId":"list_news","summary":"Pro required. Search published news by title, summary or exact source name. Publication dates are not model release dates.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"news"},"data":{"type":"array","items":{"$ref":"#/components/schemas/News"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"source":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/offers":{"get":{"operationId":"list_offers","summary":"Pro required. Read offers with eligibility, expiry, limits and verification date. Model filters only match explicit modelIds.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modelId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"providerId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"offers"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modelId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"providerId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/plans":{"get":{"operationId":"list_plans","summary":"Pro required. Read subscription plans with original currency, period, allowance, region and checked dates. Model filters only match explicit modelIds.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"modelId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"providerId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"plans"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"modelId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"providerId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sources":{"get":{"operationId":"list_sources","summary":"Pro required. Inspect source collection status, last attempt/success, completeness and errors. A new snapshot does not imply every source is fresh.","x-required-tier":"pro","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"generation","in":"query","required":false,"schema":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["catalog","prices","benchmarks","news","offers","plans"]}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"collection":{"const":"sources"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextQuery":{"anyOf":[{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"description":"Case-insensitive substring search; not a regular expression.","type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":100000},"generation":{"description":"Pin pagination to generatedAt. A changed generation returns snapshot_changed; restart at offset 0.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"sourceId":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[^\\u0000-\\u001f\\u007f]+$","description":"Exact case-sensitive identifier. Model detail also accepts an exact slug or unambiguous source-qualified alias."},"kind":{"type":"string","enum":["catalog","prices","benchmarks","news","offers","plans"]}},"additionalProperties":false},{"type":"null"}]}},"required":["limit","offset","total","nextOffset","next","nextQuery"],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","collection","data","pagination"],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/models/{id}":{"get":{"operationId":"get_model","x-required-tier":"free","summary":"Free: basic fields by canonical ID or page slug. Pro: full model by canonical ID, slug or unambiguous qualified alias. URL-encode the complete identifier. Pro related links pin generation.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":512}}],"responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"data":{"$ref":"#/components/schemas/BasicModel"}},"required":["apiVersion","generatedAt","data"],"additionalProperties":false},{"type":"object","properties":{"apiVersion":{"const":"1"},"generatedAt":{"type":"string"},"snapshotVersion":{"const":2},"storage":{"type":"object","properties":{"origin":{"enum":["R2","MEMORY","PREVIOUS","BUNDLED"]},"degraded":{"type":"boolean"}},"required":["origin","degraded"],"additionalProperties":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"data":{"$ref":"#/components/schemas/Model"},"links":{"type":"object","properties":{"page":{"type":"string"},"prices":{"type":"string"},"benchmarks":{"type":"string"},"agentBenchmarks":{"type":"string"},"offers":{"type":"string"},"plans":{"type":"string"}},"required":[],"additionalProperties":true}},"required":["apiVersion","generatedAt","storage","sources","data","links"],"additionalProperties":true}]}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/status":{"get":{"operationId":"snapshot_status","x-required-tier":"pro","summary":"Pro snapshot counts and source status","responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"number"},"generatedAt":{"type":"string"},"counts":{"type":"object"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":[],"additionalProperties":true}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/snapshot":{"get":{"operationId":"full_snapshot","x-required-tier":"pro","summary":"Pro complete snapshot download (several megabytes), limited to30/month in addition to ordinary account quota. Prefer paginated reads.","responses":{"200":{"description":"Authenticated snapshot records. Free model responses use BasicModel and omit premium metadata; Pro responses retain full evidence. Null means unknown.","content":{"application/json":{"schema":{"type":"object","description":"Complete version2 MarketSnapshot, including exact source records"}}}},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"snapshot_changed: restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp":{"post":{"operationId":"mcp_request","summary":"Authenticated finite MCP HTTP operation. Each request counts once, including discovery/initialize/notifications; batches are refused. Free can list/get basic models; other tools require Pro.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"One JSON-RPC message; use an MCP client."}}}},"responses":{"200":{"description":"SDK JSON or finite SSE response; tool query/entitlement failures use isError and error code/status."},"400":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"401":{"description":"Account API key required, invalid, expired or revoked. Cookies do not grant machine access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"403":{"description":"Pro subscription or verified account required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"405":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"408":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"413":{"description":"Request or result exceeds bounds","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"415":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"429":{"description":"Account quota exceeded; shared across keys and API/MCP. Honor Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"500":{"description":"Error; no data returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}},"503":{"description":"Account or subscription service unavailable; access fails closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpError"}}}}}}}},"components":{"schemas":{"BasicModel":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"developer":{"type":"string"},"modality":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"contextWindow":{"type":["number","null"]},"releasedAt":{"type":["string","null"]},"pageUrl":{"type":"string","format":"uri"}},"required":["id","name","developer","modality","capabilities","contextWindow","releasedAt","pageUrl"],"additionalProperties":false},"Model":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"developer":{"type":"string"},"modality":{"type":"string"},"description":{"type":"string"},"highlight":{"anyOf":[{"type":"string"},{"type":"null"}]},"aliases":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"id":{"type":"string"}},"required":["source","id"],"additionalProperties":true}},"capabilities":{"type":"array","items":{"type":"string"}},"videoOperations":{"type":"array","items":{"type":"object","properties":{"operation":{"type":"string"},"source":{"type":"string"},"endpointId":{"type":"string"},"checkedAt":{"type":"string"}},"required":[],"additionalProperties":true}},"contextWindow":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"parameters":{"anyOf":[{"type":"string"},{"type":"null"}]},"openWeights":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"listedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"firstSeenAt":{"type":"string"},"updatedAt":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}},"required":["label","url"],"additionalProperties":true}},"routeIds":{"type":"array","items":{"type":"string"}},"resultIds":{"type":"array","items":{"type":"string"}}},"required":["id","slug","name","developer","modality","aliases","sourceUrls","routeIds","resultIds"],"additionalProperties":true},"Price":{"type":"object","properties":{"id":{"type":"string"},"modelId":{"type":"string"},"sourceId":{"type":"string"},"providerId":{"type":"string"},"provider":{"type":"string"},"endpointId":{"type":"string"},"via":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string"},"sourceUrl":{"type":"string"},"currency":{"const":"USD"},"unit":{"type":"string"},"input":{"anyOf":[{"type":"number"},{"type":"null"}]},"output":{"anyOf":[{"type":"number"},{"type":"null"}]},"cachedInput":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"configuration":{"anyOf":[{"type":"string"},{"type":"null"}]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"pricingScope":{"enum":["standard","conditional"]},"providerStatus":{"enum":["operational","degraded","unreported"]},"billingComponent":{"type":"string"},"comparisonKey":{"type":"string"},"contextWindow":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"checkedAt":{"type":"string"},"available":{"type":"boolean"}},"required":["id","modelId","sourceId","providerId","endpointId","currency","unit","input","output","cachedInput","price","configuration","checkedAt","available"],"additionalProperties":true},"Metric":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"shortName":{"type":"string"},"category":{"type":"string"},"version":{"type":"string"},"unit":{"type":"string"},"higherIsBetter":{"type":"boolean"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"sourceSnapshot":{"type":"object","properties":{"revision":{"type":"string"},"publishedAt":{"type":"string"},"url":{"type":"string"}},"required":[],"additionalProperties":true}},"required":["id","sourceId","name","version","unit","higherIsBetter","sourceUrl"],"additionalProperties":true},"Benchmark":{"type":"object","properties":{"id":{"type":"string"},"modelId":{"type":"string"},"metricId":{"type":"string"},"value":{"type":"number"},"sourceModelId":{"type":"string"},"sourceModelName":{"type":"string"},"configuration":{"type":"string"},"evaluatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"checkedAt":{"type":"string"},"sourceUrl":{"type":"string"},"reportedBy":{"type":"string"},"reportingNote":{"type":"string"},"sourceSnapshot":{"type":"object","properties":{"revision":{"type":"string"},"publishedAt":{"type":"string"},"url":{"type":"string"}},"required":[],"additionalProperties":true},"confidenceInterval":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"},"level":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":[],"additionalProperties":true},"sampleSize":{"type":"number"},"metric":{"anyOf":[{"$ref":"#/components/schemas/Metric"},{"type":"null"}]},"interpretation":{"type":"object","properties":{"name":{"type":"string"},"shortName":{"type":"string"},"qualifier":{"anyOf":[{"type":"string"},{"type":"null"}]},"harness":{"anyOf":[{"type":"string"},{"type":"null"}]},"provisional":{"type":"boolean"}},"required":[],"additionalProperties":true}},"required":["id","modelId","metricId","value","configuration","checkedAt","sourceUrl","reportedBy","metric","interpretation"],"additionalProperties":true},"AgentBenchmark":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"benchmark":{"type":"string"},"version":{"type":"string"},"sourceModelId":{"type":"string"},"modelName":{"type":"string"},"modelId":{"anyOf":[{"type":"string"},{"type":"null"}]},"agentName":{"type":"string"},"agentVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasoningEffort":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"},"confidenceInterval":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"},"level":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":[],"additionalProperties":true},"sampleSize":{"type":"number"},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"evaluatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"checkedAt":{"type":"string"},"sourceUrl":{"type":"string"},"submissionUrl":{"type":"string"},"agentUrl":{"type":"string"},"modelUrl":{"type":"string"}},"required":["id","sourceId","benchmark","version","modelId","modelName","agentName","agentVersion","reasoningEffort","score","checkedAt","sourceUrl"],"additionalProperties":true},"News":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"publishedAt":{"type":"string"},"summary":{"type":"string"},"tasks":{"type":"array","items":{"type":"string"}}},"required":["id","title","url","source","publishedAt","summary"],"additionalProperties":true},"Offer":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"providerId":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string"},"description":{"type":"string"},"eligibility":{"type":"string"},"limits":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"verifiedAt":{"type":"string"},"sourceUrl":{"type":"string"},"url":{"type":"string"},"modelIds":{"type":"array","items":{"type":"string"}},"endpointIds":{"type":"array","items":{"type":"string"}},"modelSource":{"type":"string"},"refreshMode":{"type":"string"},"discounts":{"type":"array","items":{"type":"object","properties":{"endpointId":{"type":"string"},"percent":{"type":"number"}},"required":[],"additionalProperties":true}}},"required":["id","providerId","title","kind","eligibility","limits","expiresAt","verifiedAt","sourceUrl"],"additionalProperties":true},"Plan":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"url":{"type":"string"},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"enum":["USD","CNY"]},"period":{"type":"string"},"access":{"type":"string"},"allowance":{"type":"string"},"caveat":{"type":"string"},"tasks":{"type":"array","items":{"type":"string"}},"verifiedAt":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}},"required":["label","url"],"additionalProperties":true}},"checkedAt":{"type":"string"},"priceCheckedAt":{"type":"string"},"region":{"type":"string"},"modelCoverage":{"type":"string"},"modelIds":{"type":"array","items":{"type":"string"}},"endpointIds":{"type":"array","items":{"type":"string"}},"modelSource":{"type":"string"},"refreshMode":{"type":"string"}},"required":["id","name","provider","price","currency","period","allowance","caveat","verifiedAt","sources"],"additionalProperties":true},"Source":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"kind":{"type":"string"},"lastAttemptAt":{"type":"string"},"lastSuccessAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"enum":["ok","error"]},"count":{"type":"number"},"availableCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"complete":{"type":"boolean"},"error":{"type":"string"},"requests":{"type":"number"},"bytes":{"type":"number"}},"required":["id","name","kind","lastAttemptAt","lastSuccessAt","status","count","complete"],"additionalProperties":true},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":true}},"required":["error"],"additionalProperties":true},"McpError":{"type":"object","properties":{"jsonrpc":{"const":"2.0"},"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","properties":{"code":{"type":"string"},"status":{"type":"integer"}},"required":[],"additionalProperties":true}},"required":["code","message"],"additionalProperties":true}},"required":["jsonrpc","id","error"],"additionalProperties":true}},"securitySchemes":{"accountApiKey":{"type":"http","scheme":"bearer","bearerFormat":"Some AI Stuff account API key","description":"Use an account API key, not a browser session cookie or OAuth token. Obtain and revoke keys on the account page."}}}}