mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-19 17:09:47 +08:00
Jim Liu 宝玉
c3cbce9ce3
BREAKING CHANGE: removed `baoyu-imagine` and `baoyu-image-cards`. All functionality now lives under `baoyu-image-gen` and `baoyu-xhs-images` respectively. Cross-skill `## Image Generation Tools` examples updated across baoyu-article-illustrator, baoyu-comic, baoyu-cover-image, baoyu-infographic, and baoyu-slide-deck. Migration: existing `~/.baoyu-skills/baoyu-imagine/EXTEND.md` configs are auto-renamed to `…/baoyu-image-gen/EXTEND.md` on first run via the legacy-path resolver in `scripts/main.ts`.
36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
---
|
|
name: codex-image2-fallback
|
|
description: Fallback behavior when baoyu-image-gen lacks OpenAI API credentials but Codex/native image generation is available
|
|
---
|
|
|
|
# Codex Image2 Fallback
|
|
|
|
When using `baoyu-image-gen` with `--provider openai --model gpt-image-2`, the CLI can fail with:
|
|
|
|
```text
|
|
OPENAI_API_KEY is required. Codex/ChatGPT desktop login does not automatically grant OpenAI Images API access to this script.
|
|
```
|
|
|
|
This 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.
|
|
|
|
## Practical fallback pattern
|
|
|
|
1. Try `baoyu-image-gen` when provider credentials are available.
|
|
2. If it fails only because `OPENAI_API_KEY` is missing, do not leave the user waiting.
|
|
3. Prefer a Codex/native raster backend in this order:
|
|
- Codex runtime native `imagegen` skill/tool, if available.
|
|
- Repo-level `scripts/codex-imagegen.sh`, if `codex` CLI is installed/logged in and the calling skill supports the wrapper.
|
|
- Hermes native `image_generate`, if available.
|
|
4. Be transparent about reference-image behavior:
|
|
- If the fallback backend accepts references, pass the reference images.
|
|
- 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.
|
|
5. Return the generated media path or structured backend error promptly.
|
|
|
|
## User-facing wording
|
|
|
|
Use concise wording such as:
|
|
|
|
> 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].
|
|
|
|
Avoid implying that `baoyu-image-gen --provider openai` can use Codex OAuth without a dedicated provider implementation.
|