{"openapi":"3.1.0","info":{"title":"Cardinal sourcing API","version":"1.0.0","description":"Read manufacturer-backed accelerator references, educational resources and memory estimates, or submit an authorized sourcing inquiry. Catalog entries are references, not confirmed inventory or binding offers. A received request is not a reservation or completed purchase. Region and currency preferences do not identify a local office. Public endpoints require no API key or account. Use /api/v1 for integrations; existing /api paths remain supported aliases. No retirement date is announced. Breaking changes require a new major URL version. See /developers for version and retry policy. Read, estimate and sandbox operations share a 120 requests/minute client quota; real inquiries retain a separate five new requests/rolling-hour quota."},"servers":[{"url":"https://cardinalsilicon.com"}],"paths":{"/api/v1/catalog":{"get":{"operationId":"getCatalog","summary":"Read the public accelerator catalog","responses":{"200":{"description":"Published models and exact variants","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[],"description":"Read the public accelerator catalog. Public access without an API key. Catalog values describe manufacturer references, not confirmed stock or offers."}},"/api/v1/catalog/{variantId}":{"get":{"operationId":"getVariant","summary":"Read an exact accelerator configuration","parameters":[{"name":"variantId","in":"path","required":true,"schema":{"type":"string"},"example":"h100-sxm5-80gb"}],"responses":{"200":{"description":"Manufacturer reference for one variant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Variant"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"404":{"description":"Unknown variant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[],"description":"Read an exact accelerator configuration. Public access without an API key. Catalog values describe manufacturer references, not confirmed stock or offers."}},"/api/v1/requests":{"post":{"operationId":"submitSourcingRequest","summary":"Submit a buying or selling inquiry","description":"This creates a real inquiry. Submit only with the buyer or seller's authorization. The API returns 202 only after durable storage. Email notification may follow asynchronously. Reuse the same Idempotency-Key for retries of the same body. A reused key with different content is invalid. This endpoint is not a sandbox. Maximum body size is 16384 UTF-8 bytes. Five new requests per client per rolling hour; identical idempotent retries do not create another inquiry.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"UUID v4 for each distinct inquiry; retain it for retries","schema":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"},"example":{"kind":"buy","modelId":"h100","variantId":"h100-sxm5-80gb","quantity":8,"location":"Berlin, Germany","email":"buyer@example.com","notes":"Please confirm compatible server options and seller documentation","region":"EU","currency":"EUR","consent":true}}}},"responses":{"202":{"description":"Inquiry durably received; no price or supply commitment","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestAccepted"}}}},"400":{"description":"Malformed JSON, invalid idempotency key or conflicting reuse","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"POST, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body exceeds the accepted size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content-Type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Invalid fields or mismatched model and variant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Submission limit reached","headers":{"Retry-After":{"description":"Seconds before retrying","schema":{"type":"integer","minimum":1}},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}},"/api/v1/health":{"get":{"operationId":"getReadiness","summary":"Check request service readiness","description":"Configuration state only: HTTP 200 does not prove database connectivity or email delivery.","responses":{"200":{"description":"Public configuration state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Readiness"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}},"/api/v1/documents":{"get":{"operationId":"getDocuments","summary":"Read documents","description":"Manufacturer source records. Source links do not grant redistribution rights. checkedAt is an editorial review date, not a live availability check.","responses":{"200":{"description":"Manufacturer source records. Source links do not grant redistribution rights. checkedAt is an editorial review date, not a live availability check.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Documents"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}},"/api/v1/articles":{"get":{"operationId":"getArticles","summary":"Read articles","description":"Article metadata and canonical URLs, not full bodies. Retrieve article URLs as text/html or request text/markdown. No ranking or citation guarantee.","responses":{"200":{"description":"Article metadata and canonical URLs, not full bodies. Retrieve article URLs as text/html or request text/markdown. No ranking or citation guarantee.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Articles"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}},"/api/v1/documents/{documentId}":{"get":{"operationId":"getDocument","summary":"Read a manufacturer source record","parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string"},"example":"nvidia-h100-pcie"}],"responses":{"200":{"description":"Source metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"404":{"description":"Unknown document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[],"description":"Read a manufacturer source record. Public access without an API key."}},"/api/v1/estimate":{"post":{"operationId":"estimateMemory","summary":"Calculate inference or full-parameter training memory","description":"Pure arithmetic; no inquiry is submitted. Maximum 4096 JavaScript string code units. Combined total bytes must not exceed Number.MAX_SAFE_INTEGER. Inference assumes uniform full-attention KV storage, excluding quantization metadata, sliding windows, prefix sharing and offloading. Training approximates mixed-precision Adam, not LoRA. Device count assumes perfect distribution and is not a throughput, topology or fit recommendation. GB is decimal, GiB binary; read returned assumptions. Overhead is adjustable, not measured. Parameters are in billions and tokens are cached tokens per sequence.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/InferenceMemoryInput"},{"$ref":"#/components/schemas/TrainingMemoryInput"}]},"examples":{"inference":{"summary":"Hypothetical 70B architecture, not a named checkpoint","value":{"workload":"inference","parametersB":70,"weightBytesPerParameter":2,"layers":80,"kvHeads":8,"headDim":128,"tokens":8192,"cacheBytesPerElement":2,"concurrency":4,"deviceCapacityGB":80}},"training":{"value":{"workload":"training","parametersB":7,"activationGB":10,"stateBytesPerParameter":18}}}}}},"responses":{"200":{"description":"Arithmetic and assumptions; Cache-Control no-store","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryEstimate"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"POST, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Input exceeds 4096 string code units","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Malformed JSON, invalid workload or bounds, or combined arithmetic overflow","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}},"/api/v1/sandbox/requests":{"post":{"operationId":"validateSandboxRequest","summary":"Validate an inquiry without submitting it","description":"Safe validation only: no inquiry storage, email, reservation or purchase. Validates the same fields and model/variant ownership as production and echoes normalized input. No Idempotency-Key is required. Use synthetic contact details. Maximum 16384 UTF-8 bytes. Shares the public 120 requests/minute quota.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"},"example":{"kind":"buy","modelId":"h100","variantId":"h100-sxm5-80gb","quantity":8,"location":"Berlin, Germany","email":"buyer@example.com","notes":"Please confirm compatible server options and seller documentation","region":"EU","currency":"EUR","consent":true}}}},"responses":{"200":{"description":"Validated only; nothing submitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SandboxValidated"}}},"headers":{"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"400":{"description":"Malformed JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Unsupported method; use a method listed in Allow. GET endpoints also support HEAD. OPTIONS returns 204 for known endpoints.","headers":{"Allow":{"schema":{"type":"string"},"example":"POST, OPTIONS"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body exceeds the accepted size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content-Type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Invalid fields or mismatched model and variant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Client quota exhausted. Honor Retry-After before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum delay in seconds"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}},"security":[]}}},"components":{"headers":{"RateLimitLimit":{"description":"Legacy compatibility field. Maximum requests in the active window","schema":{"type":"integer","minimum":0}},"RateLimitRemaining":{"description":"Legacy compatibility field. Remaining requests in the active window","schema":{"type":"integer","minimum":0}},"RateLimitReset":{"description":"Legacy compatibility field. Seconds until the active window resets","schema":{"type":"integer","minimum":0}},"RateLimitPolicy":{"description":"Quota policy using draft-ietf-httpapi-ratelimit-headers-11 structured fields; draft, not a finalized RFC.","schema":{"type":"string"},"example":"\"public\";q=120;w=60"},"RateLimit":{"description":"Remaining quota r and effective reset seconds t for the named policy; draft-ietf-httpapi-ratelimit-headers-11. Values are advisory, not guaranteed admission.","schema":{"type":"string"},"example":"\"public\";r=119;t=60"}},"responses":{"Unavailable":{"description":"Service cannot accept the operation; do not assume an inquiry was received","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Request":{"type":"object","additionalProperties":false,"required":["kind","quantity","location","email","region","currency","consent"],"properties":{"kind":{"type":"string","enum":["buy","sell"]},"modelId":{"type":"string","maxLength":80},"variantId":{"type":"string","description":"Requires modelId and must belong to that model","maxLength":120},"quantity":{"type":"integer","minimum":1,"maximum":100000},"location":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","maxLength":254},"notes":{"type":"string","maxLength":3000},"region":{"type":"string","enum":["EU","UK","US","GLOBAL"]},"currency":{"type":"string","enum":["EUR","GBP","USD"]},"condition":{"type":"string","description":"Seller-reported condition, used for selling inquiries","maxLength":100},"website":{"type":"string","maxLength":0,"description":"Leave empty"},"consent":{"type":"boolean","const":true,"description":"Acknowledges privacy information and handling of this inquiry; this is not marketing consent"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","resolution"],"properties":{"code":{"type":"string","enum":["invalid_request","payload_too_large","unsupported_media_type","validation_error","rate_limited","unavailable","not_found","idempotency_conflict","method_not_allowed","unsupported_version"]},"message":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":"string"}},"resolution":{"type":"string","minLength":1,"description":"Actionable next step; preserve the inquiry idempotency key on uncertain outcomes."},"documentation":{"type":"string","format":"uri","description":"Relevant public developer documentation."}}}}},"Catalog":{"type":"object","required":["schemaVersion","checkedAt","models"],"properties":{"schemaVersion":{"type":"integer"},"checkedAt":{"type":"string","format":"date"},"units":{"type":"object","additionalProperties":{"type":"string"}},"models":{"type":"array","items":{"type":"object","required":["id","name","manufacturer","variants"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"manufacturer":{"type":"string"},"architecture":{"type":"string"},"summary":{"type":"string"},"softwareNotes":{"type":"array","items":{"type":"string"}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}}}}}}},"Variant":{"type":"object","required":["id","name","sourceIds","checkedAt"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"formFactor":{"type":"string"},"memoryGB":{"type":["number","null"],"description":"Manufacturer-stated gigabytes per accelerator"},"memoryType":{"type":"string"},"memoryBandwidthGBs":{"type":["number","null"],"description":"Manufacturer peak decimal gigabytes per second"},"powerW":{"type":"object","properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"note":{"type":"string"},"typical":{"type":["number","null"],"minimum":0,"description":"Manufacturer typical board power in watts. Not interchangeable with maximum; read the note when sources use different labels."}}},"interconnect":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"bandwidthGBs":{"type":["number","null"]},"note":{"type":"string"},"linkCount":{"type":"integer","minimum":1,"description":"Manufacturer link count; not interchangeable with external network ports."},"ports":{"type":"integer","minimum":1,"description":"Integrated network port count; baseboard allocation may differ."},"portSpeedGbps":{"type":"integer","minimum":1,"description":"Nominal speed per port in decimal gigabits per second, not gigabytes."}}}},"sourceIds":{"type":"array","items":{"type":"string"}},"checkedAt":{"type":"string","format":"date"},"notes":{"type":"array","items":{"type":"string"}},"availability":{"type":"object","properties":{"status":{"type":"string"},"price":{"type":["number","null"]},"leadTime":{"type":["string","null"]},"stock":{"type":["integer","null"]}},"description":"Null price, stock or leadTime means unknown or unconfirmed, never zero. Confirm exact offer terms."},"compute":{"type":"array","items":{"$ref":"#/components/schemas/ComputeRate"}},"integration":{"type":"array","items":{"$ref":"#/components/schemas/IntegrationFact"}},"performanceNotes":{"type":"array","items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"lengthInches":{"type":["number","null"],"minimum":0},"heightInches":{"type":["number","null"],"minimum":0},"lengthMmWithBracket":{"type":["number","null"],"minimum":0},"lengthMmWithoutBracket":{"type":["number","null"],"minimum":0},"referenceHeightMm":{"type":["number","null"],"minimum":0},"slots":{"type":["number","null"],"minimum":0},"note":{"type":"string"}},"description":"Nominal reference dimensions; inspect units and note. Null means unverified. Clearances and accessories may be additional."},"unknownFields":{"type":"array","items":{"type":"string"},"description":"Explicit unresolved reference fields; never infer zero or unsupported values."}}},"Readiness":{"type":"object","required":["status","requests"],"properties":{"status":{"type":"string","enum":["prelaunch","live"]},"requests":{"enum":["configured","unavailable"],"type":"string"}}},"Document":{"type":"object","required":["id","title","publisher","url","format","status","redistributionStatus","notes","checkedAt","localPath","sha256"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"format":{"type":"string"},"status":{"type":"string"},"redistributionStatus":{"type":"string"},"notes":{"type":"string"},"checkedAt":{"type":"string","format":"date"},"localPath":{"type":["string","null"]},"sha256":{"type":["string","null"]}}},"Documents":{"type":"object","required":["schemaVersion","documents"],"properties":{"schemaVersion":{"type":"integer"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"}}}},"Article":{"type":"object","required":["slug","title","description","category","url","relatedModels","updatedAt","sourceUrls","readingMinutes","author","contentRepresentations"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri"},"relatedModels":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string","format":"date"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"readingMinutes":{"type":"integer"},"author":{"const":"Cardinal","type":"string"},"contentRepresentations":{"type":"array","items":{"enum":["text/html","text/markdown"],"type":"string"}}}},"Articles":{"type":"object","required":["articles"],"properties":{"articles":{"type":"array","items":{"$ref":"#/components/schemas/Article"}}}},"InferenceMemoryInput":{"type":"object","required":["parametersB","workload","weightBytesPerParameter","layers","kvHeads","headDim","tokens","cacheBytesPerElement","concurrency"],"properties":{"parametersB":{"type":"number","minimum":0.000001,"maximum":100000},"overheadFraction":{"type":"number","minimum":0,"maximum":5,"default":0.2},"deviceCapacityGB":{"type":"number","minimum":1,"maximum":10000},"workload":{"const":"inference","type":"string"},"weightBytesPerParameter":{"type":"number","minimum":0.125,"maximum":8},"layers":{"type":"integer","minimum":1,"maximum":10000},"kvHeads":{"type":"integer","minimum":1,"maximum":10000},"headDim":{"type":"integer","minimum":1,"maximum":10000},"tokens":{"type":"integer","minimum":1,"maximum":10000000},"cacheBytesPerElement":{"type":"number","minimum":0.125,"maximum":8},"concurrency":{"type":"integer","minimum":1,"maximum":1000000}}},"TrainingMemoryInput":{"type":"object","required":["parametersB","workload","activationGB"],"properties":{"parametersB":{"type":"number","minimum":0.000001,"maximum":100000},"overheadFraction":{"type":"number","minimum":0,"maximum":5,"default":0.2},"deviceCapacityGB":{"type":"number","minimum":1,"maximum":10000},"workload":{"const":"training","type":"string"},"activationGB":{"type":"number","minimum":0,"maximum":10000000},"stateBytesPerParameter":{"type":"integer","enum":[16,18],"default":18}}},"MemoryEstimate":{"type":"object","required":["memoryGB","memoryGiB","breakdown","overheadFraction","memoryOnlyDeviceLowerBound","assumptions","sources"],"properties":{"memoryGB":{"type":"number"},"memoryGiB":{"type":"number"},"breakdown":{"type":"object","required":["weightsGB","kvCacheGB","trainingStateGB","activationGB","overheadGB"],"properties":{"weightsGB":{"type":"number"},"kvCacheGB":{"type":"number"},"trainingStateGB":{"type":"number"},"activationGB":{"type":"number"},"overheadGB":{"type":"number"}}},"overheadFraction":{"type":"number"},"memoryOnlyDeviceLowerBound":{"type":["integer","null"],"minimum":1},"assumptions":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}}}},"ComputeRate":{"type":"object","required":["precision","execution","value","unit","sparsity","conditions","sourceIds"],"properties":{"precision":{"type":"string","enum":["FP64","FP32","TF32","BF16","FP16","FP8","INT8","INT4"]},"execution":{"type":"string","enum":["vector","tensor"]},"value":{"type":"number","exclusiveMinimum":0},"unit":{"type":"string","enum":["TFLOPS","TOPS"]},"sparsity":{"type":"string","enum":["dense","structured-sparse"]},"conditions":{"type":"string"},"sourceIds":{"type":"array","minItems":1,"items":{"type":"string"}}},"description":"Manufacturer peak per accelerator, not measured workload throughput. Compare only matching precision, execution and sparsity. INT rates use TOPS; floating-point rates use TFLOPS."},"IntegrationFact":{"type":"object","required":["label","value","sourceIds"],"properties":{"label":{"type":"string"},"value":{"type":"string"},"sourceIds":{"type":"array","minItems":1,"items":{"type":"string"}}},"description":"Sourced integration detail; does not certify an offered unit or server combination."},"RequestAccepted":{"type":"object","required":["requestId","status"],"properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"string","const":"received"}}},"SandboxValidated":{"type":"object","required":["status","sandbox","request"],"properties":{"status":{"type":"string","const":"validated"},"sandbox":{"type":"boolean","const":true},"request":{"$ref":"#/components/schemas/Request"}}}}},"security":[],"externalDocs":{"description":"Authentication, versioning, safe sandbox and retries","url":"https://cardinalsilicon.com/developers"}}