AI Models

The AI model catalog lists the language models an AI assistant can run on. It is global and read-only: use a model's id as ai_model_id when you create or update an AI assistant.

Endpoints

MethodPathDescription
GET/ai-modelsList AI models
GET/ai-models/:idGet an AI model

The catalog is the same for every organization. Creating, changing or deleting models is reserved to AchieveApex administrators.

The AI model object

json

Fields

FieldTypeDescription
idintegerRead-only. Use it as ai_model_id on assistants.
providerstringopenai or openrouter.
model_namestringProvider model identifier.
labelstring | nullDisplay name.
small_descriptionstring | nullShort description.
intelligenceinteger | nullIntelligence rating, 1-5.
reasoninginteger | nullReasoning rating, 1-5.
costinteger | nullCost-efficiency rating, 1-5 (5 = cheapest).
speedinteger | nullSpeed rating, 1-5.
input_price_per_1m_tokensnumberListed price per 1 million input tokens, in USD.
output_price_per_1m_tokensnumberListed price per 1 million output tokens, in USD.
statusstringvisible (shown in model pickers), not_visible_but_supported (hidden from model pickers but still supported) or not_supported.
active_in_conversationsbooleanAvailable for conversation assistants.
active_in_ticketsbooleanAvailable for support-ticket assistants.
active_in_ai_chatbooleanAvailable for ai-chat assistants.
active_in_voicebooleanAvailable for voice assistants.
provider_metadataobject | nullProvider details such as context_length and architecture. Provider pricing is removed.
created_atstring (date-time)Read-only. Creation timestamp.
updated_atstring (date-time)Read-only. Last update timestamp.
deleted_atstring (date-time) | nullRead-only. Always null in results.

Pick a model whose status is visible and whose active_in_* flag matches the assistant type.

Related

Report an issue with this documentation

Please log in to report issues with our documentation.