v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
models

Filter Models

POST for filtering - delegate to GET (BE conventions).

post/api/models/list/

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

projectstring nullable
affiliation_category'custom' | 'keywordsai'
  • custom - Custom
  • keywordsai - Keywordsai
is_managedboolean
is_called_by_custom_nameboolean
model_namestring required
base_model_namestring
display_namestring
max_context_windowinteger
input_costnumber double
output_costnumber double
cache_hit_input_costnumber double
cache_creation_input_costnumber double
respan_discount_ratenumber double nullable
streaming_supportinteger
function_callinteger
image_supportinteger
overridden_fieldsstring[]
{"stackTrail":"components:schemas:PublicModelListRequest:properties:load_balance_backups","oasType":"schema","type":"unknown","description":"Any type"}
status'active' | 'deprecated'
  • active - Active
  • deprecated - Deprecated
is_verifiedboolean

Whether the model's pricing has been human-verified. Unverified auto-discovered models are kept out of the live model dictionary.

source'hardcoded' | 'db'
  • hardcoded - Synced from Code
  • db - Database Only
model_type'chat' | 'embedding' | 'audio'
  • chat - Chat
  • embedding - Embedding
  • audio - Audio
organizationinteger nullable required

Response

projectstring nullable
supported_paramsstring required
affiliation_category'custom' | 'keywordsai'
  • custom - Custom
  • keywordsai - Keywordsai
is_managedboolean
is_called_by_custom_nameboolean
model_namestring required
base_model_namestring
display_namestring
max_context_windowinteger
input_costnumber double
output_costnumber double
cache_hit_input_costnumber double
cache_creation_input_costnumber double
respan_discount_ratenumber double nullable
streaming_supportinteger
function_callinteger
image_supportinteger
overridden_fieldsstring[]
{"stackTrail":"components:schemas:PublicModelList:properties:load_balance_backups","oasType":"schema","type":"unknown","description":"Any type"}
status'active' | 'deprecated'
  • active - Active
  • deprecated - Deprecated
is_verifiedboolean

Whether the model's pricing has been human-verified. Unverified auto-discovered models are kept out of the live model dictionary.

source'hardcoded' | 'db'
  • hardcoded - Synced from Code
  • db - Database Only
model_type'chat' | 'embedding' | 'audio'
  • chat - Chat
  • embedding - Embedding
  • audio - Audio
idstring required
is_byokboolean required
effective_discount_ratenumber double required