Skip to content

fix(types): make ImageGenerationCall result and status optional - #3558

Open
okxint wants to merge 2 commits into
openai:mainfrom
okxint:fix/image-generation-call-required-fields
Open

fix(types): make ImageGenerationCall result and status optional#3558
okxint wants to merge 2 commits into
openai:mainfrom
okxint:fix/image-generation-call-required-fields

Conversation

@okxint

@okxint okxint commented Jul 31, 2026

Copy link
Copy Markdown

result (base64 image string) and status are output-only fields populated by the API. Marking them Required on an input TypedDict forces callers to supply values they don't have and wouldn't provide when referencing an existing image generation call by id and type.

- result: Required[Optional[str]]
+ result: Optional[str]

- status: Required[Literal["in_progress", "completed", "generating", "failed"]]
+ status: Literal["in_progress", "completed", "generating", "failed"]

Fixes #2648

okxint added 2 commits July 5, 2026 10:23
Filters out content items where `text` is None before joining, preventing
a TypeError crash when the API returns null for a text block (issue openai#3063).
result (base64 image string) and status are output-only fields populated
by the API response. Marking them Required on an input TypedDict forces
callers to provide values they don't have and wouldn't supply when
referencing an existing image generation call by id and type.

Fixes openai#2648
@okxint
okxint requested a review from a team as a code owner July 31, 2026 06:44

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 91f9172b37

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +196 to +199
result: Optional[str]
"""The generated image encoded in base64."""

status: Required[Literal["in_progress", "completed", "generating", "failed"]]
status: Literal["in_progress", "completed", "generating", "failed"]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Mirror optional image fields in ResponseInputParam

This only fixes the standalone ResponseInputItemParam; the primary responses.create(..., input=...) overload imports ResponseInputParam from response_input_param.py, which defines a separate ImageGenerationCall union member that still has result: Required[Optional[str]] and status: Required[...]. In the usual responses.create(input=[{"type": "image_generation_call", "id": ...}]) path, type checkers will still require those output-only fields, so the typing bug remains for the main Responses API unless the mirrored type in response_input_param.py is updated too.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ImageGenerationCall input param type incorrectly requires result and status

1 participant