1---
2name: codex-image2-fallback
3description: Fallback behavior when baoyu-image-gen lacks OpenAI API credentials but Codex/native image generation is available
4---
5 
6# Codex Image2 Fallback
7 
8When using `baoyu-image-gen` with `--provider openai --model gpt-image-2`, the CLI can fail with:
9 
10```text
11OPENAI_API_KEY is required. Codex/ChatGPT desktop login does not automatically grant OpenAI Images API access to this script.
12```
13 
14This is expected. The `openai` provider uses the public OpenAI Images API and needs `OPENAI_API_KEY`. Codex / ChatGPT image2 entitlement is a separate runtime-native path.
15 
16## Practical fallback pattern
17 
181. Try `baoyu-image-gen` when provider credentials are available.
192. If it fails only because `OPENAI_API_KEY` is missing, do not leave the user waiting.
203. Prefer a Codex/native raster backend in this order:
21   - Codex runtime native `imagegen` skill/tool, if available.
22   - `baoyu-image-gen --provider codex-cli` (preferred — wraps the bundled `scripts/codex-imagegen/main.ts`; the underlying repo-level package lives at `packages/baoyu-codex-imagegen/src/main.ts` for standalone callers), if `codex` CLI is installed/logged in.
23   - Hermes native `image_generate`, if available.
244. Be transparent about reference-image behavior:
25   - If the fallback backend accepts references, pass the reference images.
26   - If it does not, derive a concise identity-preserving prompt from the references and state that it is a text-description fallback, not strict reference-image editing.
275. Return the generated media path or structured backend error promptly.
28 
29## User-facing wording
30 
31Use concise wording such as:
32 
33> The OpenAI API path needs `OPENAI_API_KEY`; Codex login is a separate image2 backend. I used the available Codex/native image backend instead. Reference images were [passed directly / reconstructed from visual traits].
34 
35Avoid implying that `baoyu-image-gen --provider openai` can use Codex OAuth without a dedicated provider implementation.
36