foxapi-imagegen-skill 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -54,5 +54,14 @@ shell command history.
54
54
  python ~/.codex/skills/foxapi-imagegen/scripts/foxapi_imagegen.py generate --prompt "A clean product illustration"
55
55
  ```
56
56
 
57
+ Choose the new FoxAPI image models explicitly with their model IDs:
58
+
59
+ ```bash
60
+ python ~/.codex/skills/foxapi-imagegen/scripts/foxapi_imagegen.py generate --model "gpt-image-2.5-flare" --prompt "A clean product illustration"
61
+ python ~/.codex/skills/foxapi-imagegen/scripts/foxapi_imagegen.py generate --model "gpt-image-2.5-sunburst" --prompt "A clean product illustration"
62
+ ```
63
+
64
+ Both models accept `--size`, including custom dimensions. The API may still return a different actual size or aspect ratio; use the reported `actual_size` value.
65
+
57
66
  The skill calls `https://foxapi.cn/v1/responses` with the
58
67
  `image_generation` tool and saves the returned Base64 image locally.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foxapi-imagegen-skill",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Install and configure the FoxAPI image generation Codex skill.",
5
5
  "bin": {
6
6
  "foxapi-imagegen-skill": "bin/foxapi-imagegen-skill.js"
package/skill/SKILL.md CHANGED
@@ -33,6 +33,15 @@ When this skill is selected:
33
33
  6. Save the decoded image file locally and show it inline in the final response.
34
34
  7. If credentials are missing, ask the user to run `npx --yes foxapi-imagegen-skill setup` locally instead of switching to another image tool.
35
35
 
36
+ ## Model routing
37
+
38
+ Pass the exact model ID when the user names one of these FoxAPI image models:
39
+
40
+ - `gpt-image-2.5-flare`
41
+ - `gpt-image-2.5-sunburst`
42
+
43
+ The CLI already accepts any model through `--model`; do not replace these IDs with a display name or route them to the built-in `image_gen` tool. Keep the existing default model when the user does not choose a model.
44
+
36
45
  ## Credentials
37
46
 
38
47
  Never print API keys.
@@ -114,6 +123,8 @@ The script prints JSON. If `ok` is true:
114
123
 
115
124
  FoxAPI's Responses image tool may return an actual size or quality different from the requested `--size` and `--quality`. Report the actual values from the JSON response when present.
116
125
 
126
+ The current Flare and Sunburst routes accept `--size`, including custom dimensions and aspect-ratio requests, but the returned image may be automatically resized or use a different aspect ratio. Do not promise exact pixels or a fixed ratio from the request alone; use the returned `actual_size` value and post-process the image when an exact output ratio is required.
127
+
117
128
  ## Errors
118
129
 
119
130
  Use friendly Chinese explanations: