freeimg-z-image
Generate AI images from text prompts via the free z-image-turbo model (Gitee AI serverless API, 100 free 2K images/day with a free token). One-time setup stores the token locally; then generate PNG images in any size (multiple of 8), with negative prompts and step control. Companion web app with 18000+ prompt library and 12 preset styles: https://freeimg.shenzjd.com. Use for generating, drawing, or creating images (icons, covers, illustrations, posters). Keywords: image generation, text-to-image, AI image, z-image, z-image-turbo, Gitee AI, free image, 画图, 生成图片, 文生图, AI 绘画, 免费图片生成, freeimg-z-image.
- Installs
- 200
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/wu529778790/shenzjd-skills --skill freeimg-z-image- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads freeimg-z-image automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
FreeImg Z-Image — 免费 AI 图片生成
把一句话提示词变成 2K 高清图片：底层调用 Gitee AI Serverless API 的
z-image-turbo 模型（8 步极速生成），每天约 100 张免费额度，只需一个
免费令牌。不依赖任何付费服务。
可视化网页版：freeimg.shenzjd.com —— 不想写提示词时直接用网页版：内置 18000+ 精选提示词库、12 种预设 风格（公众号封面 / 小红书封面 / 知识卡片 / 海报 / 3D 卡通 / 中国风等）、 7 种尺寸比例、历史记录与图床上传。Skill 负责让 AI 在对话里直接出图， 网页版负责人工精修与逛提示词库，两者共用同一款令牌。
When to Use
- User asks to generate / draw / create an image (icon, cover, illustration, poster, avatar)
- User mentions 文生图 / 画图 / 生成图片 / AI 绘画 / 生成头像 / 生成封面
- User wants quick AI images without paid API keys (z-image-turbo is free)
When NOT to Use:
- User wants to edit an existing image (this skill is text-to-image only) — for 垫图/图生图 use the
freeimg-hunyuanskill - User explicitly needs the Hunyuan/混元 model or the WeChat 小程序成长计划 free quota — use the
freeimg-hunyuanskill - User explicitly needs another model (DALL·E, Midjourney, Flux…) — use the corresponding skill/API
- No network access or Gitee AI is unreachable
Core Pattern
Step 0: 首次使用 — 配置免费令牌
令牌获取（免费，三步，详见 freeimg.shenzjd.com 页面教程）： 登录 ai.gitee.com/serverless-api → 任意模型详情页点「在线体验」→「API」→「添加令牌」→ 复制。
脚本按以下优先级读取令牌（不要把令牌写进仓库、日志或对话输出）：
- 环境变量
GITEE_AI_API_KEY - 本地配置文件
~/.freeimg-z-image/config.env（内容一行：GITEE_AI_API_KEY=xxxx）
都没有时脚本会打印上面的获取引导并退出；AI 应引导用户完成 Step 0，
把令牌写入 ~/.freeimg-z-image/config.env（chmod 600），只需一次。
Step 1: 生成图片
scripts/generate.mjs --prompt "提示词" --out 输出.png \
[--width 1024] [--height 1024] [--steps 8] [--negative "负向提示词"]
--width/--height：必须为 8 的倍数；常用组合见 Quick Reference--steps：默认 8（turbo 模型推荐值，越高越慢）--negative：不传时默认文字,字母,水印,签名,模糊- 接口偶发 502，脚本已内置 2 次退避重试；仍失败则换时间再试
Step 2: 交付
- 生成后先查看图片（Read 工具）确认质量，再交给用户；不满意就换提示词重新生成，不要把废图丢给用户
- 需要小尺寸（如 App 头像 144×144）时用
sips -Z 144 原图 --out 小图.png（macOS）或 ImageMagickconvert -resize缩放 - 提示词用中文即可，模型中文理解良好；结构：
风格 + 主体 + 细节 + 构图 + 无文字无水印
Quick Reference
| 需求 | 参数 | 用途 |
|---|---|---|
| 1:1 方图 | --width 1024 --height 1024（高清用 2048×2048） | 头像、图标、知识卡片 |
| 4:3 横图 | --width 2048 --height 1536 | 公众号封面（900×383 可后期裁） |
| 3:4 竖图 | --width 1536 --height 2048 | 小红书封面 |
| 16:9 宽图 | --width 2048 --height 1152 | PPT 配图、banner |
提示词模板：
{风格，如 扁平卡通插画/3D 渲染/水彩}：{主体与细节}，{构图，如 居中特写、四周留裁剪余量}，{用途，如 App 图标、缩小时仍清晰}，无文字，无水印
环境变量：GITEE_AI_API_KEY（令牌）、FREEIMG_Z_IMAGE_CONFIG（自定义配置文件路径）。
Common Mistakes
- 把令牌提交进仓库：令牌等同免费额度账号，只放
~/.freeimg-z-image/config.env或环境变量；.env文件一律.gitignore - 尺寸不是 8 的倍数：如 1000×1000 会被接口拒绝或静默取整，用 1024/1536/2048
- 图里带乱码文字：z-image 对文字渲染不稳定，需要文字时后期用设计工具加，提示词里声明「无文字」
- 生成后不检查就交付：模型偶尔产出畸形手部/构图偏移，必须先 Read 查看再给用户
- 额度耗尽还在重试：单日约 100 张免费额度，报 429/403 时提示用户明天再试或换令牌
FAQ
What does the freeimg-z-image skill do?
Generate AI images from text prompts via the free z-image-turbo model (Gitee AI serverless API, 100 free 2K images/day with a free token). One-time setup stores the token locally; then generate PNG images in any size (multiple of 8), with negative prompts and step control. Companion web app with 18000+ prompt library and 12 preset styles: https://freeimg.shenzjd.com. Use for generating, drawing, or creating images (icons, covers, illustrations, posters). Keywords: image generation, text-to-image, AI image, z-image, z-image-turbo, Gitee AI, free image, 画图, 生成图片, 文生图, AI 绘画, 免费图片生成, freeimg-z-image.
How do I install freeimg-z-image?
Run npx skills add https://github.com/wu529778790/shenzjd-skills --skill freeimg-z-image in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/freeimg-z-image/ (personal) or .claude/skills/freeimg-z-image/ (project).
Which AI agents can use freeimg-z-image?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is freeimg-z-image safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains freeimg-z-image?
It is published by wu529778790 in wu529778790/shenzjd-skills. It has 200 recorded installs.
More from wu529778790/shenzjd-skills
docker-build-deploy
wu529778790/shenzjd-skills
Use when containerizing a Node.js app and setting up GitHub Actions CI/CD to build, push to GHCR, and deploy via SSH. Multi-stage build, non-root user, caching.
dependency-audit
wu529778790/shenzjd-skills
Use when auditing project dependencies for security vulnerabilities, outdated packages, or license compliance across npm/yarn/pnpm, pip, go, and cargo.
git-hooks-setup
wu529778790/shenzjd-skills
Use when setting up git hooks (pre-commit, commit-msg, pre-push) with husky or native hooks for linting, formatting, commit conventions, and secret scanning.
db-migration-helper
wu529778790/shenzjd-skills
Use when generating database migration SQL from model or schema changes — compares current vs desired schema, detects diffs, outputs reversible safe migrations.
github-profile-beautifier
wu529778790/shenzjd-skills
Use when creating or improving a GitHub profile README — themed stats cards, project showcase, tech-stack badges, and typing banner. 5 themes, smart project ranking (snake contribution graph needs separate setup).
api-doc-generator
wu529778790/shenzjd-skills
Use when generating OpenAPI/Swagger API docs from existing code — scans routes/annotations, extracts params and responses, outputs a YAML/JSON spec.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image