messagesarray<object>ErforderlichGeordnete Gesprächszüge. Der Inhalt ist ein String oder ein Array aus Text- und image_url-Teilen. Den bisherigen Text wörtlich in eine User-Nachricht, Ton, Perspektive und feststehende Fakten in die System-Nachricht. Die letzte Nachricht darf keine assistant-Nachricht sein.
- Standardwert
- Nicht festgelegt
- Einschränkungen
- minItems:1
messages[].rolestringIm Objekt erforderlichRole of the message author.
- Standardwert
- Nicht festgelegt
- Zulässige Werte
"system""developer""user""assistant""tool"
messages[].namestringOptionalOptional name identifying the speaker within its role.
- Standardwert
- Nicht festgelegt
messages[].contentstring | array | nullOptionalMessage content, either plain text or a list of content parts.
- Standardwert
- Nicht festgelegt
{
"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"
}
}
}
}
}
]
},
"description": "Message content, either plain text or a list of content parts."
}messages[].tool_callsarray<object>OptionalTool calls the assistant requested in this message.
- Standardwert
- Nicht festgelegt
messages[].tool_call_idstringOptionalIdentifier of the tool call this message answers. Required on tool messages.
- Standardwert
- Nicht festgelegt
messages[].reasoning_contentstringOptionalReasoning text from a previous assistant reply, preserved when continuing a tool conversation.
- Standardwert
- Nicht festgelegt
{
"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"
}
}
}
}
}
]
},
"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
},
"minItems": 1,
"description": "Ordered conversation turns. Text or image parts."
}