messagesarray<object>Obligatoire256 tours ordonnés au maximum. Le contenu est une chaîne ou un tableau de parties text, image_url et video_url. La vidéo est envoyée comme fichier téléversé, et la vidéo d’une requête peut totaliser 14 MB. Mettez le corpus dans un message user, et la question plus le format de sortie dans le message system.
- Valeur par défaut
- Non définie
- Contraintes
- minItems:1maxItems:256
messages[].rolestringObligatoire dans l’objetRole of the message author.
- Valeur par défaut
- Non définie
- Valeurs autorisées
"system""developer""user""assistant""tool"
messages[].namestringFacultatifOptional name identifying the speaker within its role.
- Valeur par défaut
- Non définie
messages[].contentstring | array | nullFacultatifMessage content, either plain text or a list of content parts.
- Valeur par défaut
- Non définie
{
"type": [
"string",
"array",
"null"
],
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string"
},
"type": {
"const": "text"
}
}
},
{
"type": "object",
"required": [
"type",
"image_url"
],
"properties": {
"type": {
"const": "image_url"
},
"image_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}
}
},
{
"type": "object",
"required": [
"type",
"video_url"
],
"properties": {
"type": {
"const": "video_url"
},
"video_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}
}
}
]
},
"description": "Message content, either plain text or a list of content parts."
}messages[].tool_callsarray<object>FacultatifTool calls the assistant requested in this message.
- Valeur par défaut
- Non définie
messages[].tool_call_idstringFacultatifIdentifier of the tool call this message answers. Required on tool messages.
- Valeur par défaut
- Non définie
messages[].reasoning_contentstringFacultatifReasoning text from a previous assistant reply, preserved when continuing a tool conversation.
- Valeur par défaut
- Non définie
{
"type": "array",
"x-ui": {
"order": 100,
"widget": "chat-messages",
"primary": true
},
"items": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"reasoning_content"
]
},
"then": {
"properties": {
"role": {
"const": "assistant"
}
}
}
}
],
"required": [
"role"
],
"properties": {
"name": {
"type": "string",
"description": "Optional name identifying the speaker within its role."
},
"role": {
"enum": [
"system",
"developer",
"user",
"assistant",
"tool"
],
"type": "string",
"description": "Role of the message author."
},
"content": {
"type": [
"string",
"array",
"null"
],
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string"
},
"type": {
"const": "text"
}
}
},
{
"type": "object",
"required": [
"type",
"image_url"
],
"properties": {
"type": {
"const": "image_url"
},
"image_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}
}
},
{
"type": "object",
"required": [
"type",
"video_url"
],
"properties": {
"type": {
"const": "video_url"
},
"video_url": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}
}
}
]
},
"description": "Message content, either plain text or a list of content parts."
},
"tool_calls": {
"type": "array",
"items": {
"type": "object"
},
"description": "Tool calls the assistant requested in this message."
},
"tool_call_id": {
"type": "string",
"description": "Identifier of the tool call this message answers. Required on tool messages."
},
"reasoning_content": {
"type": "string",
"description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
}
},
"additionalProperties": false
},
"maxItems": 256,
"minItems": 1,
"description": "Conversation history in order, oldest message first."
}