@deeprelay/sdk 0.4.1 → 0.4.3

package/src/apis/RequestsApi.ts

@@ -38,6 +38,7 @@ export interface ExportRequestsRequest {
     clientRequestId?: string;
     from?: Date;
     to?: Date;
+    fallback?: boolean;
 }
 
 export interface GetRequestRequest {
@@ -53,6 +54,7 @@ export interface ListRequestsRequest {
     clientRequestId?: string;
     from?: Date;
     to?: Date;
+    fallback?: boolean;
     cursor?: string;
     limit?: number;
 }
@@ -100,6 +102,10 @@ export class RequestsApi extends runtime.BaseAPI {
             queryParameters['to'] = (requestParameters['to'] as any).toISOString();
         }
 
+        if (requestParameters['fallback'] != null) {
+            queryParameters['fallback'] = requestParameters['fallback'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -122,7 +128,7 @@ export class RequestsApi extends runtime.BaseAPI {
     }
 
     /**
-     * Streams every request-log row matching the filters as a CSV attachment, oldest columns first: `request_id, client_request_id, occurred_at, surface, model, key_id, key_name, key_prefix, status, http_status, error_code, finish_reason, prompt_tokens, completion_tokens, cached_tokens, reasoning_tokens, quota_units, cost, plan_covered, ttft_ms, duration_ms, ignored_params`. Takes the same filters and visibility rules as `GET /requests`, without the cursor and limit.  The export is counted before anything is written. When the filters match more rows than the export cap, the answer is 422 `export_too_large` and the problem body carries `max_rows`; narrow the time range or add a filter, then export again.  Requires the `serverless:read` scope. Exports have their own, tighter per-key rate limit. 
+     * Streams every request-log row matching the filters as a CSV attachment, oldest columns first: `request_id, client_request_id, occurred_at, surface, model, key_id, key_name, key_prefix, status, http_status, error_code, finish_reason, prompt_tokens, completion_tokens, cached_tokens, reasoning_tokens, quota_units, cost, plan_covered, ttft_ms, duration_ms, ignored_params, requested_model, served_model, fallback_reason`. Takes the same filters and visibility rules as `GET /requests`, without the cursor and limit.  The export is counted before anything is written. When the filters match more rows than the export cap, the answer is 422 `export_too_large` and the problem body carries `max_rows`; narrow the time range or add a filter, then export again.  Requires the `serverless:read` scope. Exports have their own, tighter per-key rate limit. 
      * Export the request log as CSV
      */
     async exportRequestsRaw(requestParameters: ExportRequestsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<string>> {
@@ -137,7 +143,7 @@ export class RequestsApi extends runtime.BaseAPI {
     }
 
     /**
-     * Streams every request-log row matching the filters as a CSV attachment, oldest columns first: `request_id, client_request_id, occurred_at, surface, model, key_id, key_name, key_prefix, status, http_status, error_code, finish_reason, prompt_tokens, completion_tokens, cached_tokens, reasoning_tokens, quota_units, cost, plan_covered, ttft_ms, duration_ms, ignored_params`. Takes the same filters and visibility rules as `GET /requests`, without the cursor and limit.  The export is counted before anything is written. When the filters match more rows than the export cap, the answer is 422 `export_too_large` and the problem body carries `max_rows`; narrow the time range or add a filter, then export again.  Requires the `serverless:read` scope. Exports have their own, tighter per-key rate limit. 
+     * Streams every request-log row matching the filters as a CSV attachment, oldest columns first: `request_id, client_request_id, occurred_at, surface, model, key_id, key_name, key_prefix, status, http_status, error_code, finish_reason, prompt_tokens, completion_tokens, cached_tokens, reasoning_tokens, quota_units, cost, plan_covered, ttft_ms, duration_ms, ignored_params, requested_model, served_model, fallback_reason`. Takes the same filters and visibility rules as `GET /requests`, without the cursor and limit.  The export is counted before anything is written. When the filters match more rows than the export cap, the answer is 422 `export_too_large` and the problem body carries `max_rows`; narrow the time range or add a filter, then export again.  Requires the `serverless:read` scope. Exports have their own, tighter per-key rate limit. 
      * Export the request log as CSV
      */
     async exportRequests(requestParameters: ExportRequestsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<string> {
@@ -238,6 +244,10 @@ export class RequestsApi extends runtime.BaseAPI {
             queryParameters['to'] = (requestParameters['to'] as any).toISOString();
         }
 
+        if (requestParameters['fallback'] != null) {
+            queryParameters['fallback'] = requestParameters['fallback'];
+        }
+
         if (requestParameters['cursor'] != null) {
             queryParameters['cursor'] = requestParameters['cursor'];
         }

package/src/models/ApiKey.ts

@@ -20,6 +20,13 @@ import {
     ApiKeyScopesToJSON,
     ApiKeyScopesToJSONTyped,
 } from './ApiKeyScopes';
+import type { ApiKeyFallbackEntry } from './ApiKeyFallbackEntry';
+import {
+    ApiKeyFallbackEntryFromJSON,
+    ApiKeyFallbackEntryFromJSONTyped,
+    ApiKeyFallbackEntryToJSON,
+    ApiKeyFallbackEntryToJSONTyped,
+} from './ApiKeyFallbackEntry';
 
 /**
  * An API key's metadata and limits. Never carries the secret.
@@ -87,6 +94,24 @@ export interface ApiKey {
      * @memberof ApiKey
      */
     staleModels?: Array<string>;
+    /**
+     * Backup models in priority order, applied to every model this key calls. Null means model fallback is off (the default). If every provider for the requested model fails before the first token with a temporary error, the next entry is tried. Entries are kept when a model leaves the plan roster or the catalog and are skipped at request time; see `fallback_entries`. Not applied to Liquid.
+     * @type {Array<string>}
+     * @memberof ApiKey
+     */
+    fallbackModels: Array<string> | null;
+    /**
+     * Present when `fallback_models` is set: one entry per backup, in order, explaining it as of now.
+     * @type {Array<ApiKeyFallbackEntry>}
+     * @memberof ApiKey
+     */
+    fallbackEntries?: Array<ApiKeyFallbackEntry>;
+    /**
+     * The model this key requested most over the last 30 days, which `above_primary` is measured against. Present only for a key with `fallback_models` and recent usage.
+     * @type {string}
+     * @memberof ApiKey
+     */
+    primaryModel?: string;
     /**
      * 
      * @type {number}
@@ -136,6 +161,7 @@ export function instanceOfApiKey(value: object): value is ApiKey {
     if (!('scopes' in value) || value['scopes'] === undefined) return false;
     if ((!('budgetCents' in (value as Record<string, any>)) && !('budget_cents' in (value as Record<string, any>))) || ((value as Record<string, any>)['budgetCents'] === undefined && (value as Record<string, any>)['budget_cents'] === undefined)) return false;
     if ((!('allowedModels' in (value as Record<string, any>)) && !('allowed_models' in (value as Record<string, any>))) || ((value as Record<string, any>)['allowedModels'] === undefined && (value as Record<string, any>)['allowed_models'] === undefined)) return false;
+    if ((!('fallbackModels' in (value as Record<string, any>)) && !('fallback_models' in (value as Record<string, any>))) || ((value as Record<string, any>)['fallbackModels'] === undefined && (value as Record<string, any>)['fallback_models'] === undefined)) return false;
     if ((!('rateLimitRps' in (value as Record<string, any>)) && !('rate_limit_rps' in (value as Record<string, any>))) || ((value as Record<string, any>)['rateLimitRps'] === undefined && (value as Record<string, any>)['rate_limit_rps'] === undefined)) return false;
     if ((!('rateLimitBurst' in (value as Record<string, any>)) && !('rate_limit_burst' in (value as Record<string, any>))) || ((value as Record<string, any>)['rateLimitBurst'] === undefined && (value as Record<string, any>)['rate_limit_burst'] === undefined)) return false;
     if ((!('expiresAt' in (value as Record<string, any>)) && !('expires_at' in (value as Record<string, any>))) || ((value as Record<string, any>)['expiresAt'] === undefined && (value as Record<string, any>)['expires_at'] === undefined)) return false;
@@ -164,6 +190,9 @@ export function ApiKeyFromJSONTyped(json: any, ignoreDiscriminator: boolean): Ap
         'budgetResetsAt': json['budget_resets_at'] == null ? undefined : (new Date(json['budget_resets_at'])),
         'allowedModels': json['allowed_models'] == null ? null : json['allowed_models'],
         'staleModels': json['stale_models'] == null ? undefined : json['stale_models'],
+        'fallbackModels': json['fallback_models'] == null ? null : json['fallback_models'],
+        'fallbackEntries': json['fallback_entries'] == null ? undefined : ((json['fallback_entries'] as Array<any>).map(ApiKeyFallbackEntryFromJSON)),
+        'primaryModel': json['primary_model'] == null ? undefined : json['primary_model'],
         'rateLimitRps': json['rate_limit_rps'],
         'rateLimitBurst': json['rate_limit_burst'],
         'expiresAt': (json['expires_at'] == null ? null : new Date(json['expires_at'])),
@@ -194,6 +223,9 @@ export function ApiKeyToJSONTyped(value?: ApiKey | null, ignoreDiscriminator: bo
         'budget_resets_at': value['budgetResetsAt'] == null ? value['budgetResetsAt'] : value['budgetResetsAt'].toISOString(),
         'allowed_models': value['allowedModels'],
         'stale_models': value['staleModels'],
+        'fallback_models': value['fallbackModels'],
+        'fallback_entries': value['fallbackEntries'] == null ? undefined : ((value['fallbackEntries'] as Array<any>).map(ApiKeyFallbackEntryToJSON)),
+        'primary_model': value['primaryModel'],
         'rate_limit_rps': value['rateLimitRps'],
         'rate_limit_burst': value['rateLimitBurst'],
         'expires_at': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),

package/src/models/ApiKeyCreate.ts

@@ -43,6 +43,12 @@ export interface ApiKeyCreate {
      * @memberof ApiKeyCreate
      */
     allowedModels?: Array<string>;
+    /**
+     * Backup models in priority order. Omit it to leave model fallback off. Each entry must be a chat model in the catalog and, when the key has `allowed_models`, on that list. Duplicates are removed. An empty array, more than 3 models or an invalid entry is a 422 `validation_failed` naming the `fallback_models` field.
+     * @type {Array<string>}
+     * @memberof ApiKeyCreate
+     */
+    fallbackModels?: Array<string>;
     /**
      * 
      * @type {number}
@@ -86,6 +92,7 @@ export function ApiKeyCreateFromJSONTyped(json: any, ignoreDiscriminator: boolea
         'scopes': json['scopes'],
         'budgetCents': json['budget_cents'] == null ? undefined : json['budget_cents'],
         'allowedModels': json['allowed_models'] == null ? undefined : json['allowed_models'],
+        'fallbackModels': json['fallback_models'] == null ? undefined : json['fallback_models'],
         'rateLimitRps': json['rate_limit_rps'] == null ? undefined : json['rate_limit_rps'],
         'rateLimitBurst': json['rate_limit_burst'] == null ? undefined : json['rate_limit_burst'],
         'expiresAt': json['expires_at'] == null ? undefined : (new Date(json['expires_at'])),
@@ -107,6 +114,7 @@ export function ApiKeyCreateToJSONTyped(value?: ApiKeyCreate | null, ignoreDiscr
         'scopes': value['scopes'],
         'budget_cents': value['budgetCents'],
         'allowed_models': value['allowedModels'],
+        'fallback_models': value['fallbackModels'],
         'rate_limit_rps': value['rateLimitRps'],
         'rate_limit_burst': value['rateLimitBurst'],
         'expires_at': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),

package/src/models/ApiKeyCreated.ts

@@ -20,6 +20,13 @@ import {
     ApiKeyScopesToJSON,
     ApiKeyScopesToJSONTyped,
 } from './ApiKeyScopes';
+import type { ApiKeyFallbackEntry } from './ApiKeyFallbackEntry';
+import {
+    ApiKeyFallbackEntryFromJSON,
+    ApiKeyFallbackEntryFromJSONTyped,
+    ApiKeyFallbackEntryToJSON,
+    ApiKeyFallbackEntryToJSONTyped,
+} from './ApiKeyFallbackEntry';
 
 /**
  * The new key's metadata plus its secret (`key`), returned exactly once. The same fields as `ApiKey`, plus `key`.
@@ -87,6 +94,24 @@ export interface ApiKeyCreated {
      * @memberof ApiKeyCreated
      */
     staleModels?: Array<string>;
+    /**
+     * Backup models in priority order, applied to every model this key calls. Null means model fallback is off (the default). If every provider for the requested model fails before the first token with a temporary error, the next entry is tried. Entries are kept when a model leaves the plan roster or the catalog and are skipped at request time; see `fallback_entries`. Not applied to Liquid.
+     * @type {Array<string>}
+     * @memberof ApiKeyCreated
+     */
+    fallbackModels: Array<string> | null;
+    /**
+     * Present when `fallback_models` is set: one entry per backup, in order, explaining it as of now.
+     * @type {Array<ApiKeyFallbackEntry>}
+     * @memberof ApiKeyCreated
+     */
+    fallbackEntries?: Array<ApiKeyFallbackEntry>;
+    /**
+     * The model this key requested most over the last 30 days, which `above_primary` is measured against. Present only for a key with `fallback_models` and recent usage.
+     * @type {string}
+     * @memberof ApiKeyCreated
+     */
+    primaryModel?: string;
     /**
      * 
      * @type {number}
@@ -142,6 +167,7 @@ export function instanceOfApiKeyCreated(value: object): value is ApiKeyCreated {
     if (!('scopes' in value) || value['scopes'] === undefined) return false;
     if ((!('budgetCents' in (value as Record<string, any>)) && !('budget_cents' in (value as Record<string, any>))) || ((value as Record<string, any>)['budgetCents'] === undefined && (value as Record<string, any>)['budget_cents'] === undefined)) return false;
     if ((!('allowedModels' in (value as Record<string, any>)) && !('allowed_models' in (value as Record<string, any>))) || ((value as Record<string, any>)['allowedModels'] === undefined && (value as Record<string, any>)['allowed_models'] === undefined)) return false;
+    if ((!('fallbackModels' in (value as Record<string, any>)) && !('fallback_models' in (value as Record<string, any>))) || ((value as Record<string, any>)['fallbackModels'] === undefined && (value as Record<string, any>)['fallback_models'] === undefined)) return false;
     if ((!('rateLimitRps' in (value as Record<string, any>)) && !('rate_limit_rps' in (value as Record<string, any>))) || ((value as Record<string, any>)['rateLimitRps'] === undefined && (value as Record<string, any>)['rate_limit_rps'] === undefined)) return false;
     if ((!('rateLimitBurst' in (value as Record<string, any>)) && !('rate_limit_burst' in (value as Record<string, any>))) || ((value as Record<string, any>)['rateLimitBurst'] === undefined && (value as Record<string, any>)['rate_limit_burst'] === undefined)) return false;
     if ((!('expiresAt' in (value as Record<string, any>)) && !('expires_at' in (value as Record<string, any>))) || ((value as Record<string, any>)['expiresAt'] === undefined && (value as Record<string, any>)['expires_at'] === undefined)) return false;
@@ -171,6 +197,9 @@ export function ApiKeyCreatedFromJSONTyped(json: any, ignoreDiscriminator: boole
         'budgetResetsAt': json['budget_resets_at'] == null ? undefined : (new Date(json['budget_resets_at'])),
         'allowedModels': json['allowed_models'] == null ? null : json['allowed_models'],
         'staleModels': json['stale_models'] == null ? undefined : json['stale_models'],
+        'fallbackModels': json['fallback_models'] == null ? null : json['fallback_models'],
+        'fallbackEntries': json['fallback_entries'] == null ? undefined : ((json['fallback_entries'] as Array<any>).map(ApiKeyFallbackEntryFromJSON)),
+        'primaryModel': json['primary_model'] == null ? undefined : json['primary_model'],
         'rateLimitRps': json['rate_limit_rps'],
         'rateLimitBurst': json['rate_limit_burst'],
         'expiresAt': (json['expires_at'] == null ? null : new Date(json['expires_at'])),
@@ -202,6 +231,9 @@ export function ApiKeyCreatedToJSONTyped(value?: ApiKeyCreated | null, ignoreDis
         'budget_resets_at': value['budgetResetsAt'] == null ? value['budgetResetsAt'] : value['budgetResetsAt'].toISOString(),
         'allowed_models': value['allowedModels'],
         'stale_models': value['staleModels'],
+        'fallback_models': value['fallbackModels'],
+        'fallback_entries': value['fallbackEntries'] == null ? undefined : ((value['fallbackEntries'] as Array<any>).map(ApiKeyFallbackEntryToJSON)),
+        'primary_model': value['primaryModel'],
         'rate_limit_rps': value['rateLimitRps'],
         'rate_limit_burst': value['rateLimitBurst'],
         'expires_at': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),

package/src/models/ApiKeyFallbackEntry.ts

@@ -0,0 +1,114 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * deeprelay Public Developer API
+ * Programmatic API for deeprelay. Authenticate with API keys minted from the dashboard. See https://deeprelay.ai/docs for details.  Keys minted from the dashboard or `deeprelay login` belong to the Production server, https://api.deeprelay.ai/v1. The Demo server is an internal staging environment with its own key store.  Versioning: `/v1` is the API version. `info.version` is the revision of this `/v1` document, not a separate API.  OpenAI compatibility: chat completions follow the OpenAI request and response shapes, but not every OpenAI parameter is carried. Some are rejected with 400 `unsupported_parameter` and any parameter not declared in this spec is accepted and ignored. The full table is at https://deeprelay.ai/docs/api/inference#openai-compatibility. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@deeprelay.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * One backup model on a key, as it stands now.
+ * @export
+ * @interface ApiKeyFallbackEntry
+ */
+export interface ApiKeyFallbackEntry {
+    /**
+     * 
+     * @type {string}
+     * @memberof ApiKeyFallbackEntry
+     */
+    model: string;
+    /**
+     * `ok`: usable as a backup. `wallet_only`: the model is not on the subscription plan roster, so it backs up only requests billed to the wallet; a plan-covered request skips it. `unavailable`: the model is no longer in the catalog and is always skipped.
+     * @type {ApiKeyFallbackEntryStateEnum}
+     * @memberof ApiKeyFallbackEntry
+     */
+    state: ApiKeyFallbackEntryStateEnum;
+    /**
+     * Current input price per 1M tokens, in micro-cents. 0 when unknown or unavailable.
+     * @type {number}
+     * @memberof ApiKeyFallbackEntry
+     */
+    inputPer1mTokensMicrocents: number;
+    /**
+     * Current output price per 1M tokens, in micro-cents. 0 when unknown or unavailable.
+     * @type {number}
+     * @memberof ApiKeyFallbackEntry
+     */
+    outputPer1mTokensMicrocents: number;
+    /**
+     * True when this backup's input plus output price is above `primary_model`'s. Pricier backups are allowed; a request served by one is billed at its own price, and the key budget is checked at that price.
+     * @type {boolean}
+     * @memberof ApiKeyFallbackEntry
+     */
+    abovePrimary: boolean;
+}
+
+
+/**
+ * @export
+ */
+export const ApiKeyFallbackEntryStateEnum = {
+    Ok: 'ok',
+    WalletOnly: 'wallet_only',
+    Unavailable: 'unavailable'
+} as const;
+export type ApiKeyFallbackEntryStateEnum = typeof ApiKeyFallbackEntryStateEnum[keyof typeof ApiKeyFallbackEntryStateEnum];
+
+
+/**
+ * Check if a given object implements the ApiKeyFallbackEntry interface.
+ */
+export function instanceOfApiKeyFallbackEntry(value: object): value is ApiKeyFallbackEntry {
+    if (!('model' in value) || value['model'] === undefined) return false;
+    if (!('state' in value) || value['state'] === undefined) return false;
+    if ((!('inputPer1mTokensMicrocents' in (value as Record<string, any>)) && !('input_per_1m_tokens_microcents' in (value as Record<string, any>))) || ((value as Record<string, any>)['inputPer1mTokensMicrocents'] === undefined && (value as Record<string, any>)['input_per_1m_tokens_microcents'] === undefined)) return false;
+    if ((!('outputPer1mTokensMicrocents' in (value as Record<string, any>)) && !('output_per_1m_tokens_microcents' in (value as Record<string, any>))) || ((value as Record<string, any>)['outputPer1mTokensMicrocents'] === undefined && (value as Record<string, any>)['output_per_1m_tokens_microcents'] === undefined)) return false;
+    if ((!('abovePrimary' in (value as Record<string, any>)) && !('above_primary' in (value as Record<string, any>))) || ((value as Record<string, any>)['abovePrimary'] === undefined && (value as Record<string, any>)['above_primary'] === undefined)) return false;
+    return true;
+}
+
+export function ApiKeyFallbackEntryFromJSON(json: any): ApiKeyFallbackEntry {
+    return ApiKeyFallbackEntryFromJSONTyped(json, false);
+}
+
+export function ApiKeyFallbackEntryFromJSONTyped(json: any, ignoreDiscriminator: boolean): ApiKeyFallbackEntry {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'model': json['model'],
+        'state': json['state'],
+        'inputPer1mTokensMicrocents': json['input_per_1m_tokens_microcents'],
+        'outputPer1mTokensMicrocents': json['output_per_1m_tokens_microcents'],
+        'abovePrimary': json['above_primary'],
+    };
+}
+
+export function ApiKeyFallbackEntryToJSON(json: any): ApiKeyFallbackEntry {
+    return ApiKeyFallbackEntryToJSONTyped(json, false);
+}
+
+export function ApiKeyFallbackEntryToJSONTyped(value?: ApiKeyFallbackEntry | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'model': value['model'],
+        'state': value['state'],
+        'input_per_1m_tokens_microcents': value['inputPer1mTokensMicrocents'],
+        'output_per_1m_tokens_microcents': value['outputPer1mTokensMicrocents'],
+        'above_primary': value['abovePrimary'],
+    };
+}
+

package/src/models/ApiKeyUpdate.ts

@@ -14,7 +14,7 @@
 
 import { mapValues } from '../runtime';
 /**
- * Send only the fields to change. `null` clears `budget_cents`, `allowed_models` or `expires_at`. `scopes` cannot be changed.
+ * Send only the fields to change. `null` clears `budget_cents`, `allowed_models`, `fallback_models` or `expires_at`. `scopes` cannot be changed.
  * @export
  * @interface ApiKeyUpdate
  */
@@ -37,6 +37,12 @@ export interface ApiKeyUpdate {
      * @memberof ApiKeyUpdate
      */
     allowedModels?: Array<string> | null;
+    /**
+     * Replace the backup list (priority order), or `null` to turn model fallback off. Same rules as on create, judged against the key's allowlist after this update. An empty array is a 422 `validation_failed`; send `null` instead.
+     * @type {Array<string>}
+     * @memberof ApiKeyUpdate
+     */
+    fallbackModels?: Array<string> | null;
     /**
      * 
      * @type {number}
@@ -77,6 +83,7 @@ export function ApiKeyUpdateFromJSONTyped(json: any, ignoreDiscriminator: boolea
         'name': json['name'] == null ? undefined : json['name'],
         'budgetCents': json['budget_cents'] === undefined ? undefined : json['budget_cents'] === null ? null : json['budget_cents'],
         'allowedModels': json['allowed_models'] === undefined ? undefined : json['allowed_models'] === null ? null : json['allowed_models'],
+        'fallbackModels': json['fallback_models'] === undefined ? undefined : json['fallback_models'] === null ? null : json['fallback_models'],
         'rateLimitRps': json['rate_limit_rps'] == null ? undefined : json['rate_limit_rps'],
         'rateLimitBurst': json['rate_limit_burst'] == null ? undefined : json['rate_limit_burst'],
         'expiresAt': json['expires_at'] === undefined ? undefined : json['expires_at'] === null ? null : (new Date(json['expires_at'])),
@@ -97,6 +104,7 @@ export function ApiKeyUpdateToJSONTyped(value?: ApiKeyUpdate | null, ignoreDiscr
         'name': value['name'],
         'budget_cents': value['budgetCents'],
         'allowed_models': value['allowedModels'],
+        'fallback_models': value['fallbackModels'],
         'rate_limit_rps': value['rateLimitRps'],
         'rate_limit_burst': value['rateLimitBurst'],
         'expires_at': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),

package/src/models/ChatCompletionRequest.ts

@@ -61,6 +61,12 @@ export interface ChatCompletionRequest {
      * @memberof ChatCompletionRequest
      */
     model: string;
+    /**
+     * OpenRouter-compatible backup models for this request. `model` is the requested model and `models` lists the backups in priority order; when `model` is empty, the first entry of `models` is the requested model. An entry naming the requested model is ignored. At most 3 backups. The list replaces the API key's `fallback_models` for this request, and an empty array turns model fallback off for this request. Each backup must still pass the key's model allowlist, the request's billing mode and its capability needs, or it is skipped. Sending both `models` and the X-Deeprelay-Fallback-Models header is a 400 `invalid_request`. Chat completions only; on `/messages` and `/responses` use the header.
+     * @type {Array<string>}
+     * @memberof ChatCompletionRequest
+     */
+    models?: Array<string> | null;
     /**
      * 
      * @type {Array<ChatMessage>}
@@ -186,6 +192,7 @@ export function ChatCompletionRequestFromJSONTyped(json: any, ignoreDiscriminato
     return {
         
         'model': json['model'],
+        'models': json['models'] === undefined ? undefined : json['models'] === null ? null : json['models'],
         'messages': ((json['messages'] as Array<any>).map(ChatMessageFromJSON)),
         'temperature': json['temperature'] == null ? undefined : json['temperature'],
         'maxTokens': json['max_tokens'] == null ? undefined : json['max_tokens'],
@@ -217,6 +224,7 @@ export function ChatCompletionRequestToJSONTyped(value?: ChatCompletionRequest |
     return {
         
         'model': value['model'],
+        'models': value['models'],
         'messages': ((value['messages'] as Array<any>).map(ChatMessageToJSON)),
         'temperature': value['temperature'],
         'max_tokens': value['maxTokens'],

package/src/models/CreateWebhookEndpointRequest.ts

@@ -47,7 +47,8 @@ export const CreateWebhookEndpointRequestEventTypesEnum = {
     BalanceLow: 'balance.low',
     SubscriptionQuotaThreshold: 'subscription_quota.threshold',
     ApiKeyBudgetThreshold: 'api_key_budget.threshold',
-    MemberSpendThreshold: 'member_spend.threshold'
+    MemberSpendThreshold: 'member_spend.threshold',
+    PlanRosterModelRemoved: 'plan_roster.model_removed'
 } as const;
 export type CreateWebhookEndpointRequestEventTypesEnum = typeof CreateWebhookEndpointRequestEventTypesEnum[keyof typeof CreateWebhookEndpointRequestEventTypesEnum];
 

package/src/models/RefereeStatus.ts

@@ -21,21 +21,41 @@ import { mapValues } from '../runtime';
  */
 export interface RefereeStatus {
     /**
-     * Lifecycle state. `pending` until the spend gate is met; `qualified` inside the hold; `settled` once paid.
+     * Lifecycle state. `pending` until the gate is met; `qualified` inside the hold; `settled` once paid; `reversed` when the qualifying deposit was refunded after payout and both rewards were taken back.
      * @type {RefereeStatusStatusEnum}
      * @memberof RefereeStatus
      */
     status: RefereeStatusStatusEnum;
     /**
-     * Cumulative inference spend so far.
+     * What qualifies this referral. `deposit` (net real deposits) for current referrals; `spend` (inference usage) for referrals made under the earlier program, which keep their original terms.
+     * @type {RefereeStatusGateEnum}
+     * @memberof RefereeStatus
+     */
+    gate?: RefereeStatusGateEnum;
+    /**
+     * Progress toward the gate so far — net deposits for `deposit`, inference spend for `spend`.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    progressCents?: number;
+    /**
+     * The amount that qualifies the referral.
+     * @type {number}
+     * @memberof RefereeStatus
+     */
+    goalCents?: number;
+    /**
+     * Deprecated alias of `progress_cents`.
      * @type {number}
      * @memberof RefereeStatus
+     * @deprecated
      */
     spentCents: number;
     /**
-     * The spend that qualifies the referral.
+     * Deprecated alias of `goal_cents`.
      * @type {number}
      * @memberof RefereeStatus
+     * @deprecated
      */
     qualifySpendCents: number;
     /**
@@ -45,7 +65,7 @@ export interface RefereeStatus {
      */
     rewardCents: number;
     /**
-     * When the spend gate was met. Absent while pending.
+     * When the gate was met. Absent while pending.
      * @type {Date}
      * @memberof RefereeStatus
      */
@@ -72,10 +92,20 @@ export const RefereeStatusStatusEnum = {
     Pending: 'pending',
     Qualified: 'qualified',
     Settled: 'settled',
-    Rejected: 'rejected'
+    Rejected: 'rejected',
+    Reversed: 'reversed'
 } as const;
 export type RefereeStatusStatusEnum = typeof RefereeStatusStatusEnum[keyof typeof RefereeStatusStatusEnum];
 
+/**
+ * @export
+ */
+export const RefereeStatusGateEnum = {
+    Deposit: 'deposit',
+    Spend: 'spend'
+} as const;
+export type RefereeStatusGateEnum = typeof RefereeStatusGateEnum[keyof typeof RefereeStatusGateEnum];
+
 
 /**
  * Check if a given object implements the RefereeStatus interface.
@@ -99,6 +129,9 @@ export function RefereeStatusFromJSONTyped(json: any, ignoreDiscriminator: boole
     return {
         
         'status': json['status'],
+        'gate': json['gate'] == null ? undefined : json['gate'],
+        'progressCents': json['progress_cents'] == null ? undefined : json['progress_cents'],
+        'goalCents': json['goal_cents'] == null ? undefined : json['goal_cents'],
         'spentCents': json['spent_cents'],
         'qualifySpendCents': json['qualify_spend_cents'],
         'rewardCents': json['reward_cents'],
@@ -120,6 +153,9 @@ export function RefereeStatusToJSONTyped(value?: RefereeStatus | null, ignoreDis
     return {
         
         'status': value['status'],
+        'gate': value['gate'],
+        'progress_cents': value['progressCents'],
+        'goal_cents': value['goalCents'],
         'spent_cents': value['spentCents'],
         'qualify_spend_cents': value['qualifySpendCents'],
         'reward_cents': value['rewardCents'],

package/src/models/Referral.ts

@@ -41,13 +41,13 @@ export interface Referral {
      */
     inviteUrl: string;
     /**
-     * Friends who signed up through the link but have not yet reached the spend gate.
+     * Friends who signed up through the link but have not yet reached the qualifying deposit.
      * @type {number}
      * @memberof Referral
      */
     pending: number;
     /**
-     * Friends past the spend gate whose reward is inside the chargeback hold.
+     * Friends past the qualifying deposit whose reward is inside the chargeback hold.
      * @type {number}
      * @memberof Referral
      */
@@ -83,10 +83,17 @@ export interface Referral {
      */
     refereeRewardCents: number;
     /**
-     * The friend's cumulative inference spend that qualifies a referral.
+     * The friend's cumulative net real deposits (card, auto-pay and crypto, less refunds) that qualify a referral.
      * @type {number}
      * @memberof Referral
      */
+    qualifyDepositCents?: number;
+    /**
+     * Deprecated — referrals now qualify on deposits. Mirrors `qualify_deposit_cents`.
+     * @type {number}
+     * @memberof Referral
+     * @deprecated
+     */
     qualifySpendCents: number;
     /**
      * Days between qualification and payout (chargeback hold).
@@ -146,6 +153,7 @@ export function ReferralFromJSONTyped(json: any, ignoreDiscriminator: boolean):
         'commissionEarnedCents': json['commission_earned_cents'],
         'rewardCents': json['reward_cents'],
         'refereeRewardCents': json['referee_reward_cents'],
+        'qualifyDepositCents': json['qualify_deposit_cents'] == null ? undefined : json['qualify_deposit_cents'],
         'qualifySpendCents': json['qualify_spend_cents'],
         'holdDays': json['hold_days'],
         'commissionPct': json['commission_pct'],
@@ -173,6 +181,7 @@ export function ReferralToJSONTyped(value?: Referral | null, ignoreDiscriminator
         'commission_earned_cents': value['commissionEarnedCents'],
         'reward_cents': value['rewardCents'],
         'referee_reward_cents': value['refereeRewardCents'],
+        'qualify_deposit_cents': value['qualifyDepositCents'],
         'qualify_spend_cents': value['qualifySpendCents'],
         'hold_days': value['holdDays'],
         'commission_pct': value['commissionPct'],