OpenAIChatNode - ComfyUI Built-in Node Documentation

This node generates text responses from an OpenAI model. It sends your text prompt, and optionally images or files, to an OpenAI model and returns the generated text response.

Inputs

Parameter	Description	Data Type	Required	Range
`prompt`	Text inputs to the model, used to generate a response (default: empty string).	STRING	Yes	-
`persist_context`	This parameter is deprecated and has no effect (default: False).	BOOLEAN	Yes	-
`model`	The model used to generate the response (default: `gpt-5`)	COMBO	Yes	`gpt-6-astra` `gpt-5.6-sol` `gpt-5.6-terra` `gpt-5.6-luna` `gpt-5.5-pro` `gpt-5.5` `gpt-5` `gpt-5-mini` `gpt-5-nano` `gpt-4.1` `gpt-4.1-mini` `gpt-4.1-nano` `o4-mini` `o3` `o1-pro` `o1`
`images`	Optional image(s) to use as context for the model. To include multiple images, you can use the Batch Images node.	IMAGE	No	-
`files`	Optional file(s) to use as context for the model. Accepts inputs from the OpenAI Chat Input Files node.	OPENAI_INPUT_FILES	No	-
`advanced_options`	Optional configuration for the model. Accepts inputs from the OpenAI Chat Advanced Options node.	OPENAI_CHAT_CONFIG	No	-

Note: When an advanced_options configuration that sets a reasoning effort is connected, the selected model must support that effort value. For example, the gpt-4.1 family of models does not support any reasoning effort, gpt-5.5 supports none, low, medium, high and xhigh, and gpt-5.5-pro supports medium, high and xhigh. If the reasoning effort is not supported by the selected model, the node raises an error.

Outputs

Output Name	Description	Data Type
`output_text`	The text response generated by the OpenAI model.	STRING

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 687a6b1110518a2eaf23e240f43991b4ff91d6f01cae6c3ef55bcdac810e7a89

​Inputs

​Outputs

Inputs

Outputs