alicloud-ai-image-zimage-turbo

カテゴリ：プロバイダー

Model Studio Z-Image Turbo

DashScope のマルチモーダル生成 API を使用して、Z-Image Turbo で高速なテキストから画像への生成を行います。

重要なモデル名

次のモデル文字列のみを使用してください：

• z-image-turbo

前提条件

• 環境変数に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加してください（環境変数が優先されます）。
• リージョンのエンドポイント（北京またはシンガポール）を選択してください。判断できない場合は、最も妥当なリージョンを選ぶか、ユーザーに確認してください。

正規化されたインターフェイス（image.generate）

リクエスト

• prompt（文字列、必須）
• size（文字列、任意）、例：1024*1024
• seed（整数、任意）
• prompt_extend（bool、任意、デフォルトは false）
• base_url（文字列、任意）、API エンドポイントを上書きします

レスポンス

• image_url（文字列）
• width（整数）
• height（整数）
• prompt（文字列）
• rewritten_prompt（文字列、任意）
• reasoning（文字列、任意）
• request_id（文字列）

クイックスタート（curl）

curl -sS 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -d '{
    "model": "z-image-turbo",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [{"text": "A calm lake at dawn, a lone angler casting a line, cinematic lighting"}]
        }
      ]
    },
    "parameters": {
      "size": "1024*1024",
      "prompt_extend": false
    }
  }'

ローカルヘルパースクリプト

python skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/generate_image.py \
  --request '{"prompt":"a fishing scene at dawn, cinematic, realistic","size":"1024*1024"}' \
  --output output/ai-image-zimage-turbo/images/fishing.png \
  --print-response

サイズに関する注意

• 総ピクセル数は 512*512 から 2048*2048 の範囲にする必要があります。
• 1024*1024、1280*720、1536*864 などの一般的なサイズを推奨します。

コストに関する注意

• prompt_extend=true は false よりも高い料金がかかります。書き換えられたプロンプトが必要な場合にのみ有効にしてください。

出力先

• デフォルトの出力先：output/ai-image-zimage-turbo/images/
• OUTPUT_DIR でベースディレクトリを上書きできます。

検証

mkdir -p output/alicloud-ai-image-zimage-turbo
for f in skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-image-zimage-turbo/validate.txt

合格基準：コマンドが終了コード 0 で終了し、output/alicloud-ai-image-zimage-turbo/validate.txt が生成されること。

出力とエビデンス

• 成果物、コマンド出力、API レスポンスの概要を output/alicloud-ai-image-zimage-turbo/ に保存してください。
• 再現性を確保するため、エビデンスファイルに主要なパラメーター（リージョン／リソース ID／期間）を含めてください。

ワークフロー

1. ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うかを確認します。
2. 接続と権限を検証するため、まず最小限の読み取り専用クエリを 1 回実行します。
3. 明示的なパラメーターと範囲を指定して、対象の操作を実行します。
4. 結果を検証し、出力ファイルとエビデンスファイルを保存します。

参考資料

• リクエスト／レスポンスのスキーマとリージョン別エンドポイントについては、references/api_reference.md を参照してください。
• 公式ドキュメントについては、references/sources.md を参照してください。