messagesarray<object>必須古い順に並べたターンで。内容は文字列、またはテキスト・image_url・video_url パートの配列です。動画はアップロード済みファイルとして送り、1 回のリクエストに含める動画は合計 14 MB までです。タスク、出力の形、用語の決まりごとは system メッセージに置き、1 回の呼び出しには 1 行・1 節・1 文書だけを入れてください。
- デフォルト値
- 指定なし
- 制約
- minItems:1
messages[].rolestringオブジェクト内で必須Role of the message author.
- デフォルト値
- 指定なし
- 使用可能な値
"system""developer""user""assistant""tool"
messages[].namestring任意Optional name identifying the speaker within its role.
- デフォルト値
- 指定なし
messages[].contentstring | array | null任意Message content, either plain text or a list of content parts.
- デフォルト値
- 指定なし
{
"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>任意Tool calls the assistant requested in this message.
- デフォルト値
- 指定なし
messages[].tool_call_idstring任意Identifier of the tool call this message answers. Required on tool messages.
- デフォルト値
- 指定なし
messages[].reasoning_contentstring任意Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.
- デフォルト値
- 指定なし
{
"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
},
"minItems": 1,
"description": "Ordered conversation turns. Text content only on this endpoint."
}