Mistral AI · Schema
Mistral Chat Completion
A chat completion response generated by a Mistral language model, containing one or more message choices with token usage information.
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique identifier for the chat completion |
| object | string | Object type identifier |
| created | integer | Unix timestamp when the completion was created |
| model | string | The model used to generate the completion |
| choices | array | List of completion choices |
| usage | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://docs.mistral.ai/schemas/mistral/chat-completion.json",
"title": "Mistral Chat Completion",
"description": "A chat completion response generated by a Mistral language model, containing one or more message choices with token usage information.",
"type": "object",
"required": ["id", "object", "created", "model", "choices", "usage"],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the chat completion"
},
"object": {
"type": "string",
"enum": ["chat.completion"],
"description": "Object type identifier"
},
"created": {
"type": "integer",
"description": "Unix timestamp when the completion was created"
},
"model": {
"type": "string",
"description": "The model used to generate the completion"
},
"choices": {
"type": "array",
"description": "List of completion choices",
"items": {
"$ref": "#/$defs/Choice"
}
},
"usage": {
"$ref": "#/$defs/Usage"
}
},
"$defs": {
"Choice": {
"type": "object",
"description": "A single completion choice with a message and finish reason",
"properties": {
"index": {
"type": "integer",
"description": "Index of this choice in the list"
},
"message": {
"$ref": "#/$defs/Message"
},
"finish_reason": {
"type": "string",
"enum": ["stop", "length", "tool_calls", "model_length"],
"description": "Reason the model stopped generating tokens"
}
}
},
"Message": {
"type": "object",
"description": "A message in the conversation",
"required": ["role", "content"],
"properties": {
"role": {
"type": "string",
"enum": ["system", "user", "assistant", "tool"],
"description": "The role of the message author"
},
"content": {
"type": "string",
"description": "The text content of the message"
},
"tool_calls": {
"type": "array",
"items": {
"$ref": "#/$defs/ToolCall"
},
"description": "Tool calls made by the assistant"
},
"tool_call_id": {
"type": "string",
"description": "ID of the tool call this message responds to"
}
}
},
"ToolCall": {
"type": "object",
"description": "A function call made by the model",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the tool call"
},
"type": {
"type": "string",
"enum": ["function"]
},
"function": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The function name"
},
"arguments": {
"type": "string",
"description": "JSON-encoded function arguments"
}
}
}
}
},
"Usage": {
"type": "object",
"description": "Token usage statistics for the completion",
"properties": {
"prompt_tokens": {
"type": "integer",
"minimum": 0,
"description": "Number of tokens in the prompt"
},
"completion_tokens": {
"type": "integer",
"minimum": 0,
"description": "Number of tokens in the generated completion"
},
"total_tokens": {
"type": "integer",
"minimum": 0,
"description": "Total tokens consumed (prompt + completion)"
}
}
}
}
}