Function toOpenAIReferenceImageFile

toOpenAIReferenceImageFile(
    referenceImage:
        | { base64?: string; mimeType?: string; url?: string }
        | undefined,
    defaultFileName?: string,
    invalidUrlMessage?: string,
    missingSourceMessage?: string,
): Promise<File | undefined>
Converts a base64/Data-URI reference image into an OpenAI uploadable file.

OpenAI video input_reference requires uploaded image content rather than a remote URL. This helper preserves that provider contract while centralizing the base64/Data URI normalization.
Parameters
- referenceImage: { base64?: string; mimeType?: string; url?: string } | undefined
  Reference image input with base64, url, and optional mimeType.
- defaultFileName: string = "reference-image.png"
  Fallback filename.
- invalidUrlMessage: string = "OpenAI reference image requires uploaded image content"
  Error used when a remote URL is provided.
- missingSourceMessage: string = "referenceImage must include either base64 data or be omitted"
  Error used when no source is provided.
Returns Promise<File | undefined>
OpenAI SDK uploadable file object.

Throws
When a remote URL is provided instead of uploadable image content.
- Defined in src/providers/openai/capabilities/shared/OpenAIFileUtils.ts:89