messagesarray<object>필수오래된 순서대로 놓은 턴입니다. 내용은 문자열이거나 텍스트, image_url, video_url 파트로 이루어진 배열입니다. 비디오는 업로드한 파일로 보내며, 요청 한 건에 담는 비디오는 합계 14 MB까지 가능합니다. 작업 설명과 출력 모양, 용어 규칙은 system 메시지에 두고 호출 한 번에는 한 줄, 한 단락, 한 문서만 넣으세요.
- 기본값
- 지정되지 않음
- 제약 조건
- 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."
}