abliteration 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4954feb3c086bc804c783fa545d66687cdde13f05e7601c6006d905bee95a71
-  data.tar.gz: e3f746c6712d3b344e621ed8ec1793cec6a59d2ad52a751f7d048dbda3a42680
+  metadata.gz: 22dcd3b342509cdc83410548a8f7d6aa975cd5ff6ea8dd7752cdff63a57c15ae
+  data.tar.gz: '083faff3655e6a1721c87f23c92a80f28b3c4565c33f06ba1313af85417345ca'
 SHA512:
-  metadata.gz: 450a0f75eb10f2ee3386305af5eec41eebae627c4c04b9e2ba4fc0f93c8bbd8e343f936cdd9645435664bc8b9a9f98d685b9b3456cd1d135de0dd6ca8611b105
-  data.tar.gz: da5db6f4dd8925c982278808e5c7d803a63fb510802bea3abbd0a8c9fe2bf0b142a5f67b667c4333434a96873d9102cdfe676da5689fb101ec211229799d3e27
+  metadata.gz: 67056fce0457a1e0dc6b5ad116b24a9c222622646a205926308af85342d5f5faa15514fd6e66100914add28fc414996a343139e0ad19c50afe8182420a8f7ba1
+  data.tar.gz: 5c1b5586a094f530eaaac3ba39a8af5a5fb156d53871b4a87ca6f1830d23731454775029d6208107bf731cbc5b9ca8591838d422b124ff4c2a93eb4da0b19d67

data/README.md

@@ -97,8 +97,10 @@ Class | Method | HTTP request | Description
 *Abliteration::IndicesApi* | [**list_indices**](docs/IndicesApi.md#list_indices) | **GET** /api/v1/indices | All four indices
 *Abliteration::MethodsApi* | [**get_method**](docs/MethodsApi.md#get_method) | **GET** /api/v1/methods/{id} | Get one method
 *Abliteration::MethodsApi* | [**list_methods**](docs/MethodsApi.md#list_methods) | **GET** /api/v1/methods | List the method taxonomy
+*Abliteration::ModelsApi* | [**get_historical_deletion_summary**](docs/ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary
 *Abliteration::ModelsApi* | [**get_model**](docs/ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model
 *Abliteration::ModelsApi* | [**list_delisted_models**](docs/ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream)
+*Abliteration::ModelsApi* | [**list_historical_deletions**](docs/ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list
 *Abliteration::ModelsApi* | [**list_models**](docs/ModelsApi.md#list_models) | **GET** /api/v1/models | List models
 *Abliteration::TimelineApi* | [**list_timeline**](docs/TimelineApi.md#list_timeline) | **GET** /api/v1/timeline | Curated field events
 
@@ -110,20 +112,26 @@ Class | Method | HTTP request | Description
  - [Abliteration::DaiPoint](docs/DaiPoint.md)
  - [Abliteration::Dataset](docs/Dataset.md)
  - [Abliteration::DatasetDetail](docs/DatasetDetail.md)
+ - [Abliteration::DeletionSummary](docs/DeletionSummary.md)
+ - [Abliteration::DeletionSummaryTimelineInner](docs/DeletionSummaryTimelineInner.md)
+ - [Abliteration::DeletionSummaryTopByDownloadsInner](docs/DeletionSummaryTopByDownloadsInner.md)
  - [Abliteration::DelistedModel](docs/DelistedModel.md)
  - [Abliteration::Envelope](docs/Envelope.md)
  - [Abliteration::Error](docs/Error.md)
  - [Abliteration::Event](docs/Event.md)
  - [Abliteration::GetAuthor200Response](docs/GetAuthor200Response.md)
  - [Abliteration::GetDataset200Response](docs/GetDataset200Response.md)
+ - [Abliteration::GetHistoricalDeletionSummary200Response](docs/GetHistoricalDeletionSummary200Response.md)
  - [Abliteration::GetIndex200Response](docs/GetIndex200Response.md)
  - [Abliteration::GetMethod200Response](docs/GetMethod200Response.md)
  - [Abliteration::GetModel200Response](docs/GetModel200Response.md)
+ - [Abliteration::HistoricalDeletion](docs/HistoricalDeletion.md)
  - [Abliteration::Index](docs/Index.md)
  - [Abliteration::IndexDetail](docs/IndexDetail.md)
  - [Abliteration::ListAuthors200Response](docs/ListAuthors200Response.md)
  - [Abliteration::ListDatasets200Response](docs/ListDatasets200Response.md)
  - [Abliteration::ListDelistedModels200Response](docs/ListDelistedModels200Response.md)
+ - [Abliteration::ListHistoricalDeletions200Response](docs/ListHistoricalDeletions200Response.md)
  - [Abliteration::ListIndices200Response](docs/ListIndices200Response.md)
  - [Abliteration::ListMethods200Response](docs/ListMethods200Response.md)
  - [Abliteration::ListModels200Response](docs/ListModels200Response.md)

data/docs/DeletionSummary.md

@@ -0,0 +1,28 @@
+# Abliteration::DeletionSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total_ever_seen** | **Integer** | Live catalog size plus historical deletions. | [optional] |
+| **total_deleted** | **Integer** |  | [optional] |
+| **deletion_rate_pct** | **Float** | Percentage of ever-seen models that are now gone. | [optional] |
+| **avg_months_alive** | **Float** | Average lifespan of deleted models, in months. | [optional] |
+| **timeline** | [**Array<DeletionSummaryTimelineInner>**](DeletionSummaryTimelineInner.md) | Deletions grouped by last_seen_month, ascending. | [optional] |
+| **top_by_downloads** | [**Array<DeletionSummaryTopByDownloadsInner>**](DeletionSummaryTopByDownloadsInner.md) | Top-10 biggest casualties by peak downloads. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummary.new(
+  total_ever_seen: null,
+  total_deleted: null,
+  deletion_rate_pct: null,
+  avg_months_alive: null,
+  timeline: null,
+  top_by_downloads: null
+)
+```
+

data/docs/DeletionSummaryTimelineInner.md

@@ -0,0 +1,20 @@
+# Abliteration::DeletionSummaryTimelineInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **month** | **String** |  | [optional] |
+| **count** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTimelineInner.new(
+  month: null,
+  count: null
+)
+```
+

data/docs/DeletionSummaryTopByDownloadsInner.md

@@ -0,0 +1,24 @@
+# Abliteration::DeletionSummaryTopByDownloadsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **peak_downloads** | **Integer** |  | [optional] |
+| **last_seen_month** | **String** |  | [optional] |
+| **months_alive** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTopByDownloadsInner.new(
+  id: null,
+  peak_downloads: null,
+  last_seen_month: null,
+  months_alive: null
+)
+```
+

data/docs/GetHistoricalDeletionSummary200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::GetHistoricalDeletionSummary200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**DeletionSummary**](DeletionSummary.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::GetHistoricalDeletionSummary200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/HistoricalDeletion.md

@@ -0,0 +1,28 @@
+# Abliteration::HistoricalDeletion
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **first_seen_month** | **String** | ISO YYYY-MM of the earliest snapshot the model appears in. | [optional] |
+| **last_seen_month** | **String** | ISO YYYY-MM of the final snapshot before deletion. | [optional] |
+| **total_months_alive** | **Integer** | Whole months between first and last observation. | [optional] |
+| **peak_downloads** | **Integer** | Highest downloads count observed during the model's lifetime. | [optional] |
+| **created_at** | **String** | ISO-8601 timestamp the model was originally created on HF (from the frozen snapshot). | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::HistoricalDeletion.new(
+  id: null,
+  first_seen_month: null,
+  last_seen_month: null,
+  total_months_alive: null,
+  peak_downloads: null,
+  created_at: null
+)
+```
+

data/docs/ListHistoricalDeletions200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListHistoricalDeletions200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<HistoricalDeletion>**](HistoricalDeletion.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ListHistoricalDeletions200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/ModelsApi.md

@@ -4,11 +4,79 @@ All URIs are relative to *https://abliteration.org*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**get_historical_deletion_summary**](ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary |
 | [**get_model**](ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model |
 | [**list_delisted_models**](ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream) |
+| [**list_historical_deletions**](ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list |
 | [**list_models**](ModelsApi.md#list_models) | **GET** /api/v1/models | List models |
 
 
+## get_historical_deletion_summary
+
+> <GetHistoricalDeletionSummary200Response> get_historical_deletion_summary
+
+Historical deletions — aggregate summary
+
+Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+
+begin
+  # Historical deletions — aggregate summary
+  result = api_instance.get_historical_deletion_summary
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary: #{e}"
+end
+```
+
+#### Using the get_historical_deletion_summary_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetHistoricalDeletionSummary200Response>, Integer, Hash)> get_historical_deletion_summary_with_http_info
+
+```ruby
+begin
+  # Historical deletions — aggregate summary
+  data, status_code, headers = api_instance.get_historical_deletion_summary_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetHistoricalDeletionSummary200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetHistoricalDeletionSummary200Response**](GetHistoricalDeletionSummary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_model
 
 > <GetModel200Response> get_model(id)
@@ -155,6 +223,85 @@ end
 - **Accept**: application/json
 
 
+## list_historical_deletions
+
+> <ListHistoricalDeletions200Response> list_historical_deletions(opts)
+
+Historical deletions — paged list
+
+Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (`downloads`, default), recency (`recent`, newest deaths first) or lifespan (`lifespan`, longest-lived first — surprising deaths).
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+opts = {
+  since_month: 'since_month_example', # String | ISO YYYY-MM. Rows with last_seen_month >= it only.
+  min_peak_downloads: 56, # Integer | Only rows whose peak downloads >= this. `casualties over N` queries.
+  sort: 'downloads', # String | `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first).
+  limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+  offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
+}
+
+begin
+  # Historical deletions — paged list
+  result = api_instance.list_historical_deletions(opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions: #{e}"
+end
+```
+
+#### Using the list_historical_deletions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListHistoricalDeletions200Response>, Integer, Hash)> list_historical_deletions_with_http_info(opts)
+
+```ruby
+begin
+  # Historical deletions — paged list
+  data, status_code, headers = api_instance.list_historical_deletions_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListHistoricalDeletions200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **since_month** | **String** | ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only. | [optional] |
+| **min_peak_downloads** | **Integer** | Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries. | [optional] |
+| **sort** | **String** | &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first). | [optional][default to &#39;downloads&#39;] |
+| **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
+| **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |
+
+### Return type
+
+[**ListHistoricalDeletions200Response**](ListHistoricalDeletions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_models
 
 > <ListModels200Response> list_models(opts)

data/lib/abliteration/api/models_api.rb

@@ -19,6 +19,63 @@ module Abliteration
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Historical deletions — aggregate summary
+    # Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+    # @param [Hash] opts the optional parameters
+    # @return [GetHistoricalDeletionSummary200Response]
+    def get_historical_deletion_summary(opts = {})
+      data, _status_code, _headers = get_historical_deletion_summary_with_http_info(opts)
+      data
+    end
+
+    # Historical deletions — aggregate summary
+    # Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetHistoricalDeletionSummary200Response, Integer, Hash)>] GetHistoricalDeletionSummary200Response data, response status code and response headers
+    def get_historical_deletion_summary_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ModelsApi.get_historical_deletion_summary ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/models/historical-deletions/summary'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetHistoricalDeletionSummary200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ModelsApi.get_historical_deletion_summary",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ModelsApi#get_historical_deletion_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get one model
     # Cost: 10 credits. Priced above /authors/[id], /methods/[id] and /datasets/[id] because iterating over model ids is functionally a slow dump. The id is author/name and must be percent-encoded. Delisted models are served here even though they are hidden from the default catalog list; the response then carries `is_delisted=1` and `days_since_gone`.
     # @param id [String] 
@@ -167,6 +224,98 @@ module Abliteration
       return data, status_code, headers
     end
 
+    # Historical deletions — paged list
+    # Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (`downloads`, default), recency (`recent`, newest deaths first) or lifespan (`lifespan`, longest-lived first — surprising deaths).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :since_month ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only.
+    # @option opts [Integer] :min_peak_downloads Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries.
+    # @option opts [String] :sort &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first). (default to 'downloads')
+    # @option opts [Integer] :limit Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (default to 50)
+    # @option opts [Integer] :offset Rows to skip. Negative and non-numeric values are treated as 0. (default to 0)
+    # @return [ListHistoricalDeletions200Response]
+    def list_historical_deletions(opts = {})
+      data, _status_code, _headers = list_historical_deletions_with_http_info(opts)
+      data
+    end
+
+    # Historical deletions — paged list
+    # Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (&#x60;downloads&#x60;, default), recency (&#x60;recent&#x60;, newest deaths first) or lifespan (&#x60;lifespan&#x60;, longest-lived first — surprising deaths).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :since_month ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only.
+    # @option opts [Integer] :min_peak_downloads Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries.
+    # @option opts [String] :sort &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first). (default to 'downloads')
+    # @option opts [Integer] :limit Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (default to 50)
+    # @option opts [Integer] :offset Rows to skip. Negative and non-numeric values are treated as 0. (default to 0)
+    # @return [Array<(ListHistoricalDeletions200Response, Integer, Hash)>] ListHistoricalDeletions200Response data, response status code and response headers
+    def list_historical_deletions_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ModelsApi.list_historical_deletions ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'min_peak_downloads'].nil? && opts[:'min_peak_downloads'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"min_peak_downloads"]" when calling ModelsApi.list_historical_deletions, must be greater than or equal to 0.'
+      end
+
+      allowable_values = ["downloads", "recent", "lifespan"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 1000
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ModelsApi.list_historical_deletions, must be smaller than or equal to 1000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ModelsApi.list_historical_deletions, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling ModelsApi.list_historical_deletions, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/models/historical-deletions/list'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'since_month'] = opts[:'since_month'] if !opts[:'since_month'].nil?
+      query_params[:'min_peak_downloads'] = opts[:'min_peak_downloads'] if !opts[:'min_peak_downloads'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListHistoricalDeletions200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ModelsApi.list_historical_deletions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ModelsApi#list_historical_deletions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List models
     # Cost: 5-300+ credits, stepped by returned rows and multiplied by `1 + (offset/2500)²`. A filtered lookup up to 200 rows costs 5; a 1000-row page on the first page costs 300; on offset=10000, 5100. Filter cheap, dump expensive. See /api#pricing. Delisted models are excluded by default (`delisted=live`); pass `delisted=dead|all` to include tombstoned records. A dedicated change-stream endpoint is at GET /api/v1/models/delisted.
     # @param [Hash] opts the optional parameters