Skip to content

Python: [Feature]: Support the detail field in OpenAI Chat API image_url payload #4616

Description

Description

Description:
According to OpenAI’s official API documentation (link), the image_url property allows an optional detail field with values "auto", "low", or "high" for specifying image resolution or processing detail.
Currently, in _chat_client.py, only the url key is supported. The detail field is not included and cannot currently be configured.

Suggested Enhancement:

  • Add support for the detail field in the image_url payload, making it possible to specify the detail level when returning image URLs.
  • Optionally, allow the detail level to be set via a parameter, or configuration, with a sensible default (e.g., "auto").

Rationale:
Supporting the detail field is required for full compatibility with the OpenAI API and allows users to adjust image processing quality in chat completions.

References:

Code Sample

Language/SDK

Python

Activity

  1. changed the title [-][Feature]: Support the `detail` field in OpenAI Chat API `image_url` payload[/-] [+]Python: [Feature]: Support the `detail` field in OpenAI Chat API `image_url` payload[/+] on Mar 11, 2026
  2. added
    agentsUsage: [Issues, PRs], Target: Single agent
    and removed
    triageUsage: [Issues], Target: All issues that still need to be triaged
    on Mar 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

agentsUsage: [Issues, PRs], Target: Single agentpythonUsage: [Issues, PRs], Target: Python

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions