v1

Get full information about a chat or image understanding model with its model_id.

get/v1/language-models/{model_id}

Request

  • Base URL: https://docs.x.ai (the document declares no server; this is the origin it was published from)
  • URL: https://docs.x.ai/v1/language-models/{model_id}
  • Auth: HTTP bearer

Path parameters

model_idstring required

ID of the model to get.

Response

Success

aliasesstring[] required

Alias ID(s) of the model that user can use in a request's model field.

cached_prompt_text_token_priceinteger required

Price of a prompt text token (in USD cents per 100 million tokens) that was cached previously.

cached_prompt_text_token_price_long_contextinteger required

Price of the cached prompt text token for long context requests (USD cents per 100 million tokens). When 0, falls back to cached_prompt_text_token_price.

completion_text_token_priceinteger required

Price of the completion text token in USD cents per 100 million token.

completion_text_token_price_long_contextinteger required

Price of the completion text token for long context requests (USD cents per 100 million tokens). When 0, the standard completion_text_token_price applies.

createdinteger required

Creation time of the model in Unix timestamp.

fingerprintstring required

Fingerprint of the xAI system configuration hosting the model.

idstring required

Model ID. Obtainable from https://console.x.ai/team/default/models or https://docs.x.ai/docs/models.

input_modalitiesstring[] required

The input modalities supported by the model, e.g. "text", "image".

long_context_thresholdinteger required

Token count at or above which the long context prices apply. When 0, the model has no long context pricing tier.

objectstring required

The object type, which is always "model".

output_modalitiesstring[] required

The output modalities supported by the model, e.g. "text", "image".

owned_bystring required

Owner of the model.

prompt_image_token_priceinteger required

Price of the prompt image token in USD cents per 100 million token.

prompt_text_token_priceinteger required

Price of the prompt text token in USD cents per 100 million token.

prompt_text_token_price_long_contextinteger required

Price of the prompt text token for long context requests (USD cents per 100 million tokens). When 0, the standard prompt_text_token_price applies at all context lengths.

search_priceinteger required

Price of the search in USD cents per 100 million searches.

versionstring required

Version of the model.

Changes

No recorded changes to this operation across all 1 revision of this API.