{"openapi":"3.1.0","info":{"title":"AI for Less Public API","version":"1.0.0","description":"Anonymous read-only access to normalized, attributable AI model pricing, provider availability, capabilities and source freshness. AI for Less supplies facts; consumers choose workloads, weights, ranking and trade-offs."},"servers":[{"url":"https://aiforless.ai","description":"Production"}],"tags":[{"name":"Catalog","description":"Normalized provider/model catalog."},{"name":"Models","description":"Canonical model identity and detail."},{"name":"Providers","description":"Public provider directory."},{"name":"Sources","description":"Hardened public freshness and collection-health projection."}],"paths":{"/api/v1/provider-catalog":{"get":{"operationId":"getProviderCatalog","tags":["Catalog"],"summary":"Get the normalized provider catalog","description":"Returns the full public catalog or a strict comma-delimited provider selection. Unknown or inactive slugs fail closed. Success cache policy: public, max-age=60, stale-while-revalidate=120, no-transform","parameters":[{"name":"providers","in":"query","required":false,"description":"Comma-delimited provider slugs. Whitespace is trimmed, duplicates are removed, maximum 100 slugs and 2048 characters.","schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Stable public v1 representation.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Content-Length":{"$ref":"#/components/headers/ContentLength"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCatalogSuccess"},"example":{"data":[{"slug":"openai-direct","displayName":"OpenAI","providerType":"direct","websiteUrl":"https://openai.com/","pricingSourceUrl":"https://openai.com/api/pricing/","feeNote":null,"feeSourceUrl":null,"modelCount":1,"offerCount":1,"models":[{"providerModelId":"example-model","endpointVariant":"","modelSlug":"openai-example-model","modelName":"Example Model","developer":{"slug":"openai","name":"OpenAI"},"availability":"available","metadata":{"contextWindow":128000,"maxOutputTokens":null,"supportsImageInput":null,"supportsReasoning":null,"supportsTools":null,"isPreview":false},"capabilities":{"effective":{"contextWindow":128000,"maxOutputTokens":null,"textInput":true,"imageInput":null,"textOutput":true,"reasoning":null,"tools":null},"provenance":{"contextWindow":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"maxOutputTokens":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textInput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"imageInput":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textOutput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"reasoning":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"tools":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null}}},"components":[{"componentType":"input","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":{"nanoUsd":"250000000","usd":"0.25","display":"$0.25"},"state":"listed","rawPrice":"$0.25","rawUnit":"1M tokens","conditions":null,"sourceLabel":"Input"},{"componentType":"cached_input","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":{"nanoUsd":"0","usd":"0","display":"$0"},"state":"free","rawPrice":"$0","rawUnit":"1M tokens","conditions":null,"sourceLabel":"Cached input"},{"componentType":"cache_write","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":null,"state":"not_listed","rawPrice":null,"rawUnit":null,"conditions":null,"sourceLabel":null}],"standardComparablePricing":null,"pricing":{"observedAt":"2026-08-18T10:30:00.000Z","verifiedAt":"2026-08-18T10:30:00.000Z","provenance":{"sourceKey":"openai-pricing","sourceType":"html","sourceUrl":"https://openai.com/api/pricing/","parserVersion":"example-v1"},"freshness":{"state":"fresh","collectionStatus":"healthy"}},"quality":null}]}],"meta":{"apiVersion":"v1","schemaVersion":"2026-08-18.example","dataRevision":"0000000000000000000000000000000000000000000000000000000000000000","dataUpdatedAt":"2026-08-18T10:30:00.000Z","generatedAt":"2026-08-18T10:30:00.000Z","providerResults":[{"providerSlug":"openai-direct","status":"present"}],"costIndexReference":{"version":"cost-index-reference-v1","currency":"USD","unit":"tokens","unitQuantity":"1000000","inputPerMillionUsd":"0.05","outputPerMillionUsd":"0.40"}}}}}},"304":{"description":"Not Modified. The response body is empty and the request still consumes rate-limit quota.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"description":"Invalid parameters or an unknown provider filter.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"examples":{"InvalidRequest":{"summary":"Malformed provider filter","value":{"error":{"code":"invalid_request","message":"Query parameters failed validation","details":[{"code":"invalid_type","path":["limit"],"message":"Expected number, received nan"}]},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}},"UnknownProvider":{"summary":"Unknown or inactive provider slug","value":{"error":{"code":"unknown_provider","message":"Provider filter contains unknown or inactive provider slugs","details":{"providers":["unknown-provider"]}},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}},"429":{"description":"Anonymous per-client-IP quota exceeded.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"rate_limited","message":"Too many requests"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"500":{"description":"Sanitized unexpected server failure.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"internal_error","message":"Internal error"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"503":{"description":"The representation is temporarily unavailable, including response-size protection.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"data_unavailable","message":"The requested data is temporarily unavailable"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}}},"/api/v1/models":{"get":{"operationId":"listModels","tags":["Models"],"summary":"List canonical models","description":"Returns canonical models with effective capabilities and pagination metadata. Success cache policy: public, max-age=60, stale-while-revalidate=120, no-transform","parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum rows to return (default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","required":false,"description":"Zero-based row offset.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"developer","in":"query","required":false,"description":"Developer slug.","schema":{"type":"string","maxLength":64}},{"name":"provider","in":"query","required":false,"description":"Provider slug.","schema":{"type":"string","maxLength":64}},{"name":"active","in":"query","required":false,"description":"Use true to require active models.","schema":{"type":"string","enum":["true","false"]}},{"name":"hasPromotion","in":"query","required":false,"description":"Use true to require an active promotion.","schema":{"type":"string","enum":["true","false"]}},{"name":"vision","in":"query","required":false,"description":"Use true to require image input support.","schema":{"type":"string","enum":["true","false"]}},{"name":"serviceTier","in":"query","required":false,"description":"Service tier filter.","schema":{"type":"string","enum":["standard","batch","flex","priority","fast","unknown"]}},{"name":"search","in":"query","required":false,"description":"Case-insensitive model search, maximum 120 characters.","schema":{"type":"string","maxLength":120}},{"name":"sort","in":"query","required":false,"description":"Sort order: name, developer, recent or verified.","schema":{"type":"string","enum":["name","developer","recent","verified"]}}],"responses":{"200":{"description":"Stable public v1 representation.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Content-Length":{"$ref":"#/components/headers/ContentLength"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelsSuccess"},"example":{"data":[{"slug":"openai-example-model","displayName":"Example Model","developer":{"slug":"openai","name":"OpenAI"},"family":"Example","versionLabel":null,"isSnapshot":false,"status":"active","contextWindow":128000,"maxOutputTokens":null,"capabilities":{"effective":{"contextWindow":128000,"maxOutputTokens":null,"textInput":true,"imageInput":null,"textOutput":true,"reasoning":null,"tools":null},"provenance":{"contextWindow":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"maxOutputTokens":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textInput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"imageInput":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textOutput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"reasoning":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"tools":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null}}},"firstSeenAt":"2026-08-18T10:30:00.000Z","lastVerifiedAt":"2026-08-18T10:30:00.000Z","offerCount":1,"providers":["openai-direct"],"activePromotions":0}],"meta":{"apiVersion":"v1","schemaVersion":"2026-08-18.example","dataRevision":"0000000000000000000000000000000000000000000000000000000000000000","dataUpdatedAt":"2026-08-18T10:30:00.000Z","generatedAt":"2026-08-18T10:30:00.000Z","pagination":{"limit":5,"offset":0,"total":1,"hasMore":false}}}}}},"304":{"description":"Not Modified. The response body is empty and the request still consumes rate-limit quota.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"description":"Invalid parameters or an unknown provider filter.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"invalid_request","message":"Query parameters failed validation","details":[{"code":"invalid_type","path":["limit"],"message":"Expected number, received nan"}]},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"429":{"description":"Anonymous per-client-IP quota exceeded.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"rate_limited","message":"Too many requests"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"500":{"description":"Sanitized unexpected server failure.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"internal_error","message":"Internal error"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"503":{"description":"The representation is temporarily unavailable, including response-size protection.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"data_unavailable","message":"The requested data is temporarily unavailable"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}}},"/api/v1/models/{slug}":{"get":{"operationId":"getModel","tags":["Models"],"summary":"Get one canonical model","description":"Returns model identity, effective capabilities, provider appearances, raw pricing and comparable projections. Success cache policy: public, max-age=60, stale-while-revalidate=120, no-transform","parameters":[{"name":"slug","in":"path","required":true,"description":"Canonical model slug, 1 to 160 characters.","schema":{"type":"string","minLength":1,"maxLength":160}}],"responses":{"200":{"description":"Stable public v1 representation.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Content-Length":{"$ref":"#/components/headers/ContentLength"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelDetailSuccess"},"example":{"data":{"slug":"openai-example-model","displayName":"Example Model","developer":{"slug":"openai","name":"OpenAI"},"family":"Example","versionLabel":null,"isSnapshot":false,"status":"active","contextWindow":128000,"maxOutputTokens":null,"capabilities":{"effective":{"contextWindow":128000,"maxOutputTokens":null,"textInput":true,"imageInput":null,"textOutput":true,"reasoning":null,"tools":null},"provenance":{"contextWindow":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"maxOutputTokens":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textInput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"imageInput":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"textOutput":{"resolution":"canonical","evidenceSourceKeys":["model-card"],"evidenceProviderSlugs":[],"verifiedAt":null},"reasoning":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null},"tools":{"resolution":"unknown","evidenceSourceKeys":[],"evidenceProviderSlugs":[],"verifiedAt":null}}},"firstSeenAt":"2026-08-18T10:30:00.000Z","lastVerifiedAt":"2026-08-18T10:30:00.000Z","releaseDate":"2026-08-18","aliases":[{"providerSlug":"openai-direct","rawAlias":"example-model"}],"offers":[]},"meta":{"apiVersion":"v1","schemaVersion":"2026-08-18.example","dataRevision":"0000000000000000000000000000000000000000000000000000000000000000","dataUpdatedAt":"2026-08-18T10:30:00.000Z","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"304":{"description":"Not Modified. The response body is empty and the request still consumes rate-limit quota.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"400":{"description":"Invalid parameters or an unknown provider filter.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"invalid_request","message":"Query parameters failed validation","details":[{"code":"invalid_type","path":["limit"],"message":"Expected number, received nan"}]},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"404":{"description":"The requested model does not exist.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"not_found","message":"No such model"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"429":{"description":"Anonymous per-client-IP quota exceeded.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"rate_limited","message":"Too many requests"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"500":{"description":"Sanitized unexpected server failure.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"internal_error","message":"Internal error"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"503":{"description":"The representation is temporarily unavailable, including response-size protection.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"data_unavailable","message":"The requested data is temporarily unavailable"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}}},"/api/v1/providers":{"get":{"operationId":"listProviders","tags":["Providers"],"summary":"List providers","description":"Returns the public provider directory, official URLs, fee notes and verification counts. Success cache policy: public, max-age=60, stale-while-revalidate=120, no-transform","parameters":[],"responses":{"200":{"description":"Stable public v1 representation.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Content-Length":{"$ref":"#/components/headers/ContentLength"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvidersSuccess"},"example":{"data":[{"slug":"openai-direct","displayName":"OpenAI","providerType":"direct","websiteUrl":"https://openai.com/","pricingSourceUrl":"https://openai.com/api/pricing/","feeNote":null,"feeSourceUrl":null,"feeLastVerifiedAt":null,"offerCount":1,"activeDeals":0,"lastVerifiedAt":"2026-08-18T10:30:00.000Z"}],"meta":{"apiVersion":"v1","schemaVersion":"2026-08-18.example","dataRevision":"0000000000000000000000000000000000000000000000000000000000000000","dataUpdatedAt":"2026-08-18T10:30:00.000Z","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"304":{"description":"Not Modified. The response body is empty and the request still consumes rate-limit quota.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"429":{"description":"Anonymous per-client-IP quota exceeded.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"rate_limited","message":"Too many requests"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"500":{"description":"Sanitized unexpected server failure.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"internal_error","message":"Internal error"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"503":{"description":"The representation is temporarily unavailable, including response-size protection.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"data_unavailable","message":"The requested data is temporarily unavailable"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}}},"/api/v1/sources/status":{"get":{"operationId":"getSourceStatus","tags":["Sources"],"summary":"Get public source freshness","description":"Returns only the hardened public projection of source freshness, collection health and provenance. Success cache policy: public, max-age=30, no-transform","parameters":[],"responses":{"200":{"description":"Stable public v1 representation.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Content-Length":{"$ref":"#/components/headers/ContentLength"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceStatusSuccess"},"example":{"data":[{"key":"openai-pricing","provider":"openai-direct","sourceType":"html","sourceUrl":"https://openai.com/api/pricing/","official":true,"parserVersion":"example-v1","lastSuccessfulVerificationAt":"2026-08-18T10:30:00.000Z","contentLastChangedAt":"2026-08-18T10:30:00.000Z","freshness":"fresh","collectionStatus":"healthy"}],"meta":{"apiVersion":"v1","schemaVersion":"2026-08-18.example","dataRevision":"0000000000000000000000000000000000000000000000000000000000000000","dataUpdatedAt":"2026-08-18T10:30:00.000Z","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"304":{"description":"Not Modified. The response body is empty and the request still consumes rate-limit quota.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}}},"429":{"description":"Anonymous per-client-IP quota exceeded.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"rate_limited","message":"Too many requests"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"500":{"description":"Sanitized unexpected server failure.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"internal_error","message":"Internal error"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}},"503":{"description":"The representation is temporarily unavailable, including response-size protection.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiError"},"example":{"error":{"code":"data_unavailable","message":"The requested data is temporarily unavailable"},"meta":{"requestId":"request-example","generatedAt":"2026-08-18T10:30:00.000Z"}}}}}}}}},"components":{"schemas":{"Money":{"type":"object","properties":{"nanoUsd":{"type":"string","pattern":"^\\d+$"},"usd":{"type":"string","pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"display":{"type":"string"}},"required":["nanoUsd","usd","display"],"additionalProperties":false},"PriceComponent":{"type":"object","properties":{"componentType":{"type":"string","minLength":1,"x-extensible-enum":["input","output","cached_input","cache_write","cache_write_5m","cache_write_1h"]},"modality":{"type":"string","minLength":1,"x-extensible-enum":["text","image","audio"]},"serviceTier":{"type":"string","minLength":1,"x-extensible-enum":["standard","batch","flex","priority","fast"]},"contextTier":{"type":"string","minLength":1,"x-extensible-enum":["default","short","long"]},"inputTokenMinExclusive":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"inputTokenMaxInclusive":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"unit":{"type":"string","minLength":1},"unitQuantity":{"type":"string","pattern":"^\\d+$"},"price":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"state":{"type":"string","enum":["listed","free","not_listed"]},"rawPrice":{"anyOf":[{"type":"string"},{"type":"null"}]},"rawUnit":{"anyOf":[{"type":"string"},{"type":"null"}]},"conditions":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"sourceLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["componentType","modality","serviceTier","contextTier","inputTokenMinExclusive","inputTokenMaxInclusive","unit","unitQuantity","price","state","rawPrice","rawUnit","conditions","sourceLabel"],"additionalProperties":false,"oneOf":[{"type":"object","required":["state","price"],"properties":{"state":{"const":"not_listed"},"price":{"type":"null"}}},{"type":"object","required":["state","price"],"properties":{"state":{"const":"free"},"price":{"allOf":[{"$ref":"#/components/schemas/Money"},{"type":"object","required":["nanoUsd","usd"],"properties":{"nanoUsd":{"const":"0"},"usd":{"const":"0"}}}]}}},{"type":"object","required":["state","price"],"properties":{"state":{"const":"listed"},"price":{"allOf":[{"$ref":"#/components/schemas/Money"},{"type":"object","required":["nanoUsd"],"properties":{"nanoUsd":{"not":{"const":"0"}}}}]}}}]},"StandardComparablePricing":{"type":"object","properties":{"schemaVersion":{"const":"standard-comparable-pricing-v1","type":"string"},"derived":{"const":true,"type":"boolean"},"modality":{"const":"text","type":"string"},"serviceTier":{"const":"standard","type":"string"},"contextTier":{"type":"string","enum":["default","short"]},"unit":{"const":"tokens","type":"string"},"unitQuantity":{"const":"1000000","type":"string"},"input":{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},"output":{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},"cachedInput":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},{"type":"null"}]},"cacheWrite":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},{"type":"null"}]},"cacheWrite5m":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},{"type":"null"}]},"cacheWrite1h":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["listed","free"]},"price":{"$ref":"#/components/schemas/Money"}},"required":["state","price"],"additionalProperties":false},{"type":"null"}]},"derivedFromComponentTypes":{"type":"array","items":{"type":"string","enum":["input","output","cached_input","cache_write","cache_write_5m","cache_write_1h"]}}},"required":["schemaVersion","derived","modality","serviceTier","contextTier","unit","unitQuantity","input","output","cachedInput","cacheWrite","cacheWrite5m","cacheWrite1h","derivedFromComponentTypes"],"additionalProperties":false},"CostIndexReference":{"type":"object","properties":{"version":{"const":"cost-index-reference-v1","type":"string"},"currency":{"const":"USD","type":"string"},"unit":{"const":"tokens","type":"string"},"unitQuantity":{"const":"1000000","type":"string"},"inputPerMillionUsd":{"const":"0.05","type":"string"},"outputPerMillionUsd":{"const":"0.40","type":"string"}},"required":["version","currency","unit","unitQuantity","inputPerMillionUsd","outputPerMillionUsd"],"additionalProperties":false},"PublicPricing":{"type":"object","properties":{"observedAt":{"type":"string","format":"date-time"},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"provenance":{"type":"object","properties":{"sourceKey":{"type":"string","minLength":1},"sourceType":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"parserVersion":{"type":"string","minLength":1}},"required":["sourceKey","sourceType","sourceUrl","parserVersion"],"additionalProperties":false},"freshness":{"type":"object","properties":{"state":{"type":"string","enum":["fresh","delayed","stale","unavailable"]},"collectionStatus":{"type":"string","enum":["healthy","degraded","unavailable"]}},"required":["state","collectionStatus"],"additionalProperties":false}},"required":["observedAt","verifiedAt","provenance","freshness"],"additionalProperties":false},"EffectiveCapabilities":{"type":"object","properties":{"contextWindow":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"textInput":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"imageInput":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"textOutput":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"reasoning":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"tools":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["contextWindow","maxOutputTokens","textInput","imageInput","textOutput","reasoning","tools"],"additionalProperties":false},"ModelCapabilities":{"type":"object","properties":{"effective":{"$ref":"#/components/schemas/EffectiveCapabilities"},"provenance":{"type":"object","properties":{"contextWindow":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"maxOutputTokens":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"textInput":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"imageInput":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"textOutput":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"reasoning":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false},"tools":{"type":"object","properties":{"resolution":{"type":"string","enum":["canonical","direct_provider_consensus","hosted_provider_consensus","unknown"]},"evidenceSourceKeys":{"type":"array","items":{"type":"string"}},"evidenceProviderSlugs":{"type":"array","items":{"type":"string"}},"verifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["resolution","evidenceSourceKeys","evidenceProviderSlugs","verifiedAt"],"additionalProperties":false}},"required":["contextWindow","maxOutputTokens","textInput","imageInput","textOutput","reasoning","tools"],"additionalProperties":false}},"required":["effective","provenance"],"additionalProperties":false},"ArenaOverall":{"type":"object","properties":{"rank":{"type":"integer"},"rating":{"type":"number"},"publishDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"matchKind":{"type":"string","enum":["exact","representative_evaluation"]},"evaluationModelName":{"type":"string"},"evaluationVariant":{"anyOf":[{"type":"string"},{"type":"null"}]},"representativeSelection":{"anyOf":[{"type":"string","enum":["single_reviewed_variant","worst_reviewed_variant"]},{"type":"null"}]},"reviewedVariants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"integer"},"rating":{"type":"number"},"selected":{"type":"boolean"}},"required":["name","variant","rank","rating","selected"],"additionalProperties":false}}},"required":["rank","rating","publishDate","matchKind","evaluationModelName","evaluationVariant","representativeSelection","reviewedVariants"],"additionalProperties":false},"Quality":{"type":"object","properties":{"schemaVersion":{"const":"quality-v1","type":"string"},"arenaOverall":{"$ref":"#/components/schemas/ArenaOverall"}},"required":["schemaVersion","arenaOverall"],"additionalProperties":false},"PublicOffer":{"type":"object","properties":{"id":{"type":"string"},"offerId":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["direct","aggregator"]}},"required":["slug","name","type"],"additionalProperties":false},"providerModelId":{"type":"string"},"providerDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"endpointVariant":{"type":"string"},"availability":{"type":"string","enum":["available","unconfirmed","unavailable","removed"]},"firstSeenAt":{"type":"string","format":"date-time"},"lastSeenAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","properties":{"contextWindow":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"supportsImageInput":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"supportsReasoning":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"supportsTools":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["contextWindow","maxOutputTokens","supportsImageInput","supportsReasoning","supportsTools","isPreview"],"additionalProperties":false},"pricing":{"anyOf":[{"type":"object","properties":{"priceSetId":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"currency":{"type":"string"},"verification":{"type":"string"},"parserVersion":{"type":"string"},"components":{"type":"array","items":{"$ref":"#/components/schemas/PriceComponent"}}},"required":["priceSetId","observedAt","currency","verification","parserVersion","components"],"additionalProperties":false},{"type":"null"}]},"promotions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"promotionType":{"type":"string"},"statedDiscountPercent":{"anyOf":[{"type":"string"},{"type":"null"}]},"endDateKnown":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","promotionType","statedDiscountPercent","endDateKnown","endsAt","sourceUrl"],"additionalProperties":false}}},"required":["id","offerId","provider","providerModelId","providerDisplayName","endpointVariant","availability","firstSeenAt","lastSeenAt","metadata","pricing","promotions"],"additionalProperties":false},"ProviderCatalogModel":{"type":"object","properties":{"providerModelId":{"type":"string"},"endpointVariant":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelName":{"type":"string"},"developer":{"anyOf":[{"type":"object","properties":{"slug":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["slug","name"],"additionalProperties":false},{"type":"null"}]},"availability":{"type":"string","enum":["available","unconfirmed","unavailable","removed"]},"metadata":{"type":"object","properties":{"contextWindow":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"supportsImageInput":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"supportsReasoning":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"supportsTools":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["contextWindow","maxOutputTokens","supportsImageInput","supportsReasoning","supportsTools","isPreview"],"additionalProperties":false},"capabilities":{"$ref":"#/components/schemas/ModelCapabilities"},"components":{"type":"array","items":{"$ref":"#/components/schemas/PriceComponent"}},"standardComparablePricing":{"anyOf":[{"$ref":"#/components/schemas/StandardComparablePricing"},{"type":"null"}]},"pricing":{"anyOf":[{"$ref":"#/components/schemas/PublicPricing"},{"type":"null"}]},"quality":{"anyOf":[{"$ref":"#/components/schemas/Quality"},{"type":"null"}]},"arenaOverall":{"$ref":"#/components/schemas/ArenaOverall","deprecated":true,"description":"Deprecated transitional alias; use quality.arenaOverall."}},"required":["providerModelId","endpointVariant","modelSlug","modelName","developer","availability","metadata","capabilities","components","standardComparablePricing","pricing","quality"],"additionalProperties":false},"ProviderCatalogEntry":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"providerType":{"type":"string","enum":["direct","aggregator"]},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"pricingSourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeSourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelCount":{"type":"integer","minimum":0},"offerCount":{"type":"integer","minimum":0},"models":{"type":"array","items":{"$ref":"#/components/schemas/ProviderCatalogModel"}}},"required":["slug","displayName","providerType","websiteUrl","pricingSourceUrl","feeNote","feeSourceUrl","modelCount","offerCount","models"],"additionalProperties":false},"ModelSummary":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"developer":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"family":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"isSnapshot":{"type":"boolean"},"status":{"type":"string","enum":["active","deprecated","unknown"]},"contextWindow":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"capabilities":{"$ref":"#/components/schemas/ModelCapabilities"},"firstSeenAt":{"type":"string","format":"date-time"},"lastVerifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"offerCount":{"type":"integer","minimum":0},"providers":{"type":"array","items":{"type":"string"}},"activePromotions":{"type":"integer","minimum":0}},"required":["slug","displayName","developer","family","versionLabel","isSnapshot","status","contextWindow","maxOutputTokens","capabilities","firstSeenAt","lastVerifiedAt","offerCount","providers","activePromotions"],"additionalProperties":false},"ModelDetail":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"developer":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"family":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"isSnapshot":{"type":"boolean"},"status":{"type":"string","enum":["active","deprecated","unknown"]},"contextWindow":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"maxOutputTokens":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"capabilities":{"$ref":"#/components/schemas/ModelCapabilities"},"firstSeenAt":{"type":"string","format":"date-time"},"lastVerifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"releaseDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"aliases":{"type":"array","items":{"type":"object","properties":{"providerSlug":{"type":"string"},"rawAlias":{"type":"string"}},"required":["providerSlug","rawAlias"],"additionalProperties":false}},"offers":{"type":"array","items":{"$ref":"#/components/schemas/PublicOffer"}}},"required":["slug","displayName","developer","family","versionLabel","isSnapshot","status","contextWindow","maxOutputTokens","capabilities","firstSeenAt","lastVerifiedAt","releaseDate","aliases","offers"],"additionalProperties":false},"Provider":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"providerType":{"type":"string","enum":["direct","aggregator"]},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"pricingSourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeSourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"feeLastVerifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"offerCount":{"type":"integer","minimum":0},"activeDeals":{"type":"integer","minimum":0},"lastVerifiedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["slug","displayName","providerType","websiteUrl","pricingSourceUrl","feeNote","feeSourceUrl","feeLastVerifiedAt","offerCount","activeDeals","lastVerifiedAt"],"additionalProperties":false},"PublicSourceStatus":{"type":"object","properties":{"key":{"type":"string","minLength":1},"provider":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"sourceType":{"type":"string","minLength":1},"sourceUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"official":{"type":"boolean"},"parserVersion":{"type":"string","minLength":1},"lastSuccessfulVerificationAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"contentLastChangedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"freshness":{"type":"string","enum":["fresh","delayed","stale","unavailable"]},"collectionStatus":{"type":"string","enum":["healthy","degraded","unavailable"]}},"required":["key","provider","sourceType","sourceUrl","official","parserVersion","lastSuccessfulVerificationAt","contentLastChangedAt","freshness","collectionStatus"],"additionalProperties":false},"Pagination":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":0},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}},"required":["limit","offset","total","hasMore"],"additionalProperties":false},"ProviderResult":{"type":"object","properties":{"providerSlug":{"type":"string"},"status":{"type":"string","enum":["present","empty"]}},"required":["providerSlug","status"],"additionalProperties":false},"StableSuccessMeta":{"type":"object","properties":{"apiVersion":{"const":"v1","type":"string"},"schemaVersion":{"type":"string","minLength":1},"dataRevision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"dataUpdatedAt":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"pagination":{"$ref":"#/components/schemas/Pagination"},"providerResults":{"type":"array","items":{"$ref":"#/components/schemas/ProviderResult"}},"costIndexReference":{"$ref":"#/components/schemas/CostIndexReference"}},"required":["apiVersion","schemaVersion","dataRevision","dataUpdatedAt","generatedAt"],"additionalProperties":false},"PublicApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unknown_provider","not_found","rate_limited","internal_error","data_unavailable"]},"message":{"type":"string"},"details":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"path":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"}]}},"message":{"type":"string"}},"required":["code","path","message"],"additionalProperties":true}},{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string"}}},"required":["providers"],"additionalProperties":false}]}},"required":["code","message"],"additionalProperties":false},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"],"additionalProperties":false}},"required":["error","meta"],"additionalProperties":false},"ProviderCatalogSuccess":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderCatalogEntry"}},"meta":{"$ref":"#/components/schemas/StableSuccessMeta"}}},"ModelsSuccess":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ModelSummary"}},"meta":{"$ref":"#/components/schemas/StableSuccessMeta"}}},"ModelDetailSuccess":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ModelDetail"},"meta":{"$ref":"#/components/schemas/StableSuccessMeta"}}},"ProvidersSuccess":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}},"meta":{"$ref":"#/components/schemas/StableSuccessMeta"}}},"SourceStatusSuccess":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicSourceStatus"}},"meta":{"$ref":"#/components/schemas/StableSuccessMeta"}}}},"headers":{"ETag":{"description":"Strong SHA-256 validator for exact serialized response bytes.","schema":{"type":"string"}},"LastModified":{"description":"Represented-data update time.","schema":{"type":"string"}},"CacheControl":{"description":"Public cache policy including no-transform.","schema":{"type":"string"}},"ContentLength":{"description":"Exact UTF-8 byte length at the origin on 200.","schema":{"type":"integer","minimum":0}},"RequestId":{"description":"Request correlation identifier; absent from stable success bodies.","schema":{"type":"string"}},"RateLimitLimit":{"description":"Current anonymous request limit.","schema":{"type":"integer","minimum":0}},"RateLimitRemaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer","minimum":0}},"RateLimitReset":{"description":"Limiter reset value supplied by the server.","schema":{"type":"integer","minimum":0}},"RetryAfter":{"description":"Delay before retrying a 429 response.","schema":{"type":"integer","minimum":0}}},"examples":{"ListedPrice":{"value":{"componentType":"input","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":{"nanoUsd":"250000000","usd":"0.25","display":"$0.25"},"state":"listed","rawPrice":"$0.25","rawUnit":"1M tokens","conditions":null,"sourceLabel":"Input"}},"FreePrice":{"value":{"componentType":"cached_input","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":{"nanoUsd":"0","usd":"0","display":"$0"},"state":"free","rawPrice":"$0","rawUnit":"1M tokens","conditions":null,"sourceLabel":"Cached input"}},"NotListedPrice":{"value":{"componentType":"cache_write","modality":"text","serviceTier":"standard","contextTier":"default","inputTokenMinExclusive":null,"inputTokenMaxInclusive":null,"unit":"tokens","unitQuantity":"1000000","price":null,"state":"not_listed","rawPrice":null,"rawUnit":null,"conditions":null,"sourceLabel":null}}}},"externalDocs":{"description":"Human-readable Public API documentation","url":"https://aiforless.ai/docs/api"},"x-artifact-cache-control":"public, max-age=300, stale-while-revalidate=3600, no-transform"}