jimeng-api-image-gen

Jimeng API による画像生成

テキストプロンプトまたは画像入力を使用して、Volcengine の Jimeng 4.0 API で高品質な AI 画像を生成します。

環境変数の設定

Access Key／Secret Key を取得

# ~/.zshrc or ~/.zshenv
export VOLC_ACCESSKEY="your_access_key_id"
export VOLC_SECRETKEY="your_secret_access_key"

出力時の動作（重要）

画像の生成が成功したら、必ず画像をユーザーに直接表示してください！

生成が完了したら、次の形式で出力してください。

![Generated Image](IMAGE_URL)

**Generation Info:**
- Prompt: [User's original prompt]
- Size: [Image dimensions]
- Save Path: [Local file path, if applicable]

出力例

![Shiba Inu under cherry blossoms](https://example.com/image.png)

**Generation Info:**
- Prompt: Shiba Inu under cherry blossom tree, warm sunlight, healing art style
- Size: 2304 × 1728
- Save Path: /generated_images/[Generated Image] **important**

注意事項

1. 画像を直接表示するには、Markdown の画像構文 ![description](URL) を優先してください
2. コピーや共有が簡単にできるよう、オンラインリンクも提示してください
3. ローカルに保存した場合は、ローカルファイルのパスを表示してください
4. 画像が複数ある場合は、それぞれに番号を付けて表示してください

クイックスタート

ステップ 1：生成を実行する

# Text-to-image
scripts/generate_image.py "A white Siamese cat sitting on a windowsill, sunlight streaming in"

# With specific size
scripts/generate_image.py "Mountain sunset landscape" --size 2K

# Image-to-image editing
scripts/generate_image.py "Change to watercolor style" --images https://example.com/input.jpg

# Save to file
scripts/generate_image.py "Serene lake at sunset" --output /generated_images/lake.png

API 設定

パラメーター	値	説明
エンドポイント	https://visual.volcengineapi.com	API のベース URL
送信アクション	CVSync2AsyncSubmitTask	非同期生成タスクを送信
クエリアクション	CVSync2AsyncGetResult	タスクの結果を照会
バージョン	2022-08-31	API バージョン
サービス	cv	署名に使用するサービス名
リージョン	cn-north-1	署名に使用するリージョン
req_key	jimeng_t2i_v40	Jimeng AI 4.0 モデル識別子

画像サイズのオプション

プリセット解像度

プリセット	解像度	ピクセル数
1K	1024×1024	1,048,576
2K	2048×2048	4,194,304（デフォルト）
4K	4096×4096	16,777,216

正確な寸法

--width と --height をセットで使用します。

scripts/generate_image.py "prompt" --width 2560 --height 1440

推奨アスペクト比：

• 1:1（2048x2048）- ソーシャルメディアの投稿
• 4:3（2304x1728）- プレゼンテーション
• 16:9（2560x1440）- ワイドスクリーンディスプレイ
• 9:16（1440x2560）- モバイルの縦向き表示
• 3:2（2496x1664）- 写真

制約：

• 幅 × 高さは [1024×1024, 4096×4096] の範囲内である必要があります
• アスペクト比（幅／高さ）は [1/16, 16] の範囲内である必要があります
• 推奨：より高品質な画像を得るには、2K 以上を使用してください

コマンドラインオプション

scripts/generate_image.py PROMPT [OPTIONS]

Arguments:
  PROMPT              Text prompt for image generation (required, max 800 chars)

Options:
  --size SIZE         Image size: 1K, 2K, 4K or WxH (default: 2K)
  --width WIDTH       Exact width (requires --height)
  --height HEIGHT     Exact height (requires --width)
  --images URL [...]  Input image URLs for image-to-image (max 10)
  --watermark         Add "AI Generated" watermark
  --scale FLOAT       Text influence 0-1 (default: 0.5)
  --force-single      Force single image output
  --output PATH       Download image to file
  --json              Output raw JSON response

Environment Variables:
  VOLC_ACCESSKEY           Access Key ID (required)
  VOLC_SECRETKEY           Secret Access Key (required)
  JIMENG_API_URL           API endpoint (default: https://visual.volcengineapi.com)
  JIMENG_API_TIMEOUT       Request timeout seconds (default: 120)
  JIMENG_POLL_INTERVAL     Polling interval seconds (default: 2)
  JIMENG_MAX_POLL_ATTEMPTS Max polling attempts (default: 60)

認証

このスキルでは、Volcengine IAM v4 署名認証（HMAC-SHA256）を使用します。署名の手順は次のとおりです。

1. ヘッダー content-type;host;x-content-sha256;x-date を含む正規リクエストを構築します
2. 正規リクエストの SHA256 ハッシュを計算します
3. 署名キーを導出します：secret_key → 日付 → リージョン → サービス → "request"
4. 導出したキーで署名対象文字列に署名します
5. リクエストに Authorization ヘッダーを追加します

参考：HTTP リクエスト例

エラーコード

コード	メッセージ	説明
10000	Success	リクエストに成功しました
50411	Pre Img Risk Not Pass	入力画像がコンテンツチェックに合格しませんでした
50511	Post Img Risk Not Pass	出力画像がコンテンツチェックに合格しませんでした
50412	Text Risk Not Pass	入力テキストがコンテンツチェックに合格しませんでした
50413	Post Text Risk Not Pass	入力テキストにセンシティブな単語が含まれています
50429	Request Has Reached API Limit	レート制限を超えました。後でもう一度お試しください
50500	Internal Error	サーバーエラー
timeout	Request timeout	JIMENG_API_TIMEOUT を増やしてください

入力／出力の上限

入力画像：

• 形式：JPEG、PNG のみ
• 最大ファイル数：10 枚
• 最大サイズ：1 枚あたり 15MB
• 最大解像度：4096×4096
• アスペクト比（W/H）：[1/3, 3]

出力：

• 最大画像数：15 - （入力画像数）
• 形式：PNG
• URL の有効期間：24 時間

参考ドキュメント

• Jimeng AI 4.0 API ドキュメント
• HTTP リクエスト例
• Volcengine コンソール
• API キー管理