freeimg-z-image

FreeImg Z-Image — 無料 AI 画像生成

一文のプロンプトを 2K 高解像度画像に変換します。Gitee AI Serverless API の z-image-turbo モデル（8 ステップの高速生成）を呼び出し、毎日約 100 枚の無料枠を利用できます。必要なのは無料のトークン 1 つだけです。 有料サービスには依存しません。

ビジュアル版ウェブページ：freeimg.shenzjd.com —— プロンプトを書きたくないときは、ウェブ版を直接お使いください。18000+ の厳選プロンプトライブラリ、12 種類のプリセットスタイル （公式アカウントのカバー / 小紅書のカバー / ナレッジカード / ポスター / 3D カートゥーン / 中国風など）、 7 種類のアスペクト比、履歴、画像ホスティングへのアップロードを備えています。Skill は AI が会話内で直接画像を生成できるようにし、 ウェブ版は手動での仕上げとプロンプトライブラリの閲覧を担います。どちらも同じトークンを使用します。

使用する場合

• ユーザーが画像の生成／描画／作成（アイコン、カバー、イラスト、ポスター、アバター）を求めている場合
• ユーザーが文生図／画像の描画／画像生成／AI ペイント／アバター生成／カバー生成に言及した場合
• 有料 API キーを使わずに手早く AI 画像を作りたい場合（z-image-turbo は無料です）

使用しない場合：

• ユーザーが既存画像の 編集 を求めている場合（このスキルはテキストからの画像生成のみです）。画像を参照した生成／画像から画像を生成する場合は freeimg-hunyuan スキルを使用してください
• ユーザーが Hunyuan／混元モデル、または WeChat 小程序成长计划の無料枠を明示的に必要としている場合は、freeimg-hunyuan スキルを使用してください
• ユーザーが別のモデル（DALL·E、Midjourney、Flux…）を明示的に必要としている場合は、対応するスキル／API を使用してください
• ネットワークにアクセスできない、または Gitee AI に接続できない場合

基本的な流れ

ステップ 0：初回使用 — 無料トークンの設定

トークンの取得方法（無料、3 ステップ。詳しくは freeimg.shenzjd.com のページの手順をご覧ください）： ai.gitee.com/serverless-api にログイン → 任意のモデルの詳細ページで「オンライン体験」→「API」→「トークンを追加」→ コピー。

スクリプトは次の優先順位でトークンを読み込みます（トークンをリポジトリ、ログ、会話の出力に書き込まないでください）。

1. 環境変数 GITEE_AI_API_KEY
2. ローカル設定ファイル ~/.freeimg-z-image/config.env（内容は 1 行：GITEE_AI_API_KEY=xxxx）

どちらも設定されていない場合、スクリプトは上記の取得手順を表示して終了します。AI はユーザーにステップ 0 の完了を案内し、 トークンを ~/.freeimg-z-image/config.env に書き込む（chmod 600）よう促してください。設定は一度だけで済みます。

ステップ 1：画像を生成する

scripts/generate.mjs --prompt "提示词" --out 输出.png \
  [--width 1024] [--height 1024] [--steps 8] [--negative "负向提示词"]

• --width/--height：8 の倍数である必要があります。よく使う組み合わせはクイックリファレンスを参照してください
• --steps：既定値は 8（turbo モデルの推奨値。数値が大きいほど遅くなります）
• --negative：指定しない場合は 文字,字母,水印,签名,模糊 が既定値です
• インターフェースでまれに 502 が発生します。スクリプトには 2 回のバックオフ再試行が組み込まれています。それでも失敗する場合は、時間をおいて再試行してください

ステップ 2：納品する

• 生成後はまず画像を確認し（Read ツール）、品質を確かめてからユーザーに渡してください。満足できない場合はプロンプトを変えて再生成し、使えない画像をユーザーに渡さないでください
• 小さいサイズ（App のアバター 144×144 など）が必要な場合は、sips -Z 144 原図 --out 小图.png（macOS）または ImageMagick の convert -resize で縮小してください
• プロンプトは中国語で構いません。モデルは中国語をよく理解します。構成：スタイル + 主体 + 詳細 + 構図 + 文字・透かしなし

クイックリファレンス

用途	パラメーター	目的
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 の画像、バナー

プロンプトのテンプレート：

{风格，如 扁平卡通插画/3D 渲染/水彩}：{主体与细节}，{构图，如 居中特写、四周留裁剪余量}，{用途，如 App 图标、缩小时仍清晰}，无文字，无水印

環境変数：GITEE_AI_API_KEY（トークン）、FREEIMG_Z_IMAGE_CONFIG（カスタム設定ファイルのパス）。

よくある間違い

• トークンをリポジトリにコミットする：トークンは無料枠のアカウントに相当します。~/.freeimg-z-image/config.env または環境変数にのみ保存し、.env ファイルは必ず .gitignore に追加してください
• サイズが 8 の倍数ではない：1000×1000 などのサイズはインターフェースで拒否されるか、通知なく丸められます。1024／1536／2048 を使用してください
• 画像に文字化けが含まれる：z-image の文字描画は安定していません。文字が必要な場合は、後からデザインツールで追加し、プロンプトで「文字なし」と指定してください
• 生成後に確認せず納品する：モデルが手の形を崩したり、構図をずらしたりすることがあります。必ず先に Read で確認してからユーザーに渡してください
• 無料枠を使い切っても再試行し続ける：1 日あたりの無料枠は約 100 枚です。429／403 が返された場合は、翌日に再試行するか、別のトークンを使うようユーザーに案内してください