高速な生成が可能な軽量 Text-to-Image モデルで、中国語および英語のテキストレンダリングと柔軟な解像度をサポートします。
使用例
入力プロンプト | 出力画像 |
|---|---|
スタイリッシュな若い女性の写真。短い黒髪で、活気ある漫画風の壁画の前に自信を持って立っている。全身黒の衣装を着用:フリル付きカラーのふっくらとしたボンバー ジャケット、カーゴショートパンツ、フィッシュネットタイツ、ずっしりとした黒のドクターマーチン、腰からゴールドチェーンがぶら下がっている。背景には4つのカラフルなコミック風パネルがある:1つは「GRAND STAGE」と表示され、スニーカーとゲータレードのボトルが含まれる;もう1つは緑のナイキ スニーカーとピザのスライスを表示;3つ目は「HARAJUKU st」と表示され、浮遊する靴が描かれている;4つ目は青いマウスがスケートボードに乗っており、「Takeshita WELCOME.」というテキストが添えられている。主となる鮮やかな色は黄色、ティール、オレンジ、ピンク、緑。吹き出し、ハーフトーンパターン、遊び心のあるキャラクターが、アーバンストリートアートの美学を引き立てている。日中の自然光がシーンを均等に照らしており、足元の地面は白いタイル張りの舗装。全身ポートレート、中央構図、やや傾いた姿勢、カメラに向かって真正面から視線を送っている。高精細、シャープな焦点、ダイナミックなフレーミング。 | ![]() |
モデル概要
モデル名 | 説明 | 出力画像仕様 |
|---|---|---|
z-image-turbo | 高速な軽量画像生成モデル | 画像解像度:512×512 ~ 2048×2048 ピクセル。size パラメーター設定の推奨解像度をご参照ください。 画像フォーマット:png 画像枚数:固定で 1 枚。 |
前提条件
API キーを作成し、API キーを環境変数として設定します。
同期 HTTP 呼び出し
シンガポール:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
中国 (北京):POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
WorkspaceId は、実際の ワークスペース ID に置き換えてください。
リクエストパラメーターリクエストヘッダーContent-Typestring (必須)リクエストのコンテンツタイプ。必ず application/json にしてください。Authorization string (必須)Model Studio API キーを使用してリクエストを認証します。例:Bearer sk-xxxx。リクエスト本文modelstring (必須)モデル名:z-image-turbo。input object (必須)入力内容。
プロパティ messages array (必須)リクエスト内容の配列。シングルターンのみ対応です。1 組のロールとコンテンツを渡してください。マルチターンはサポートされていません。
プロパティ role string (必須)メッセージのロール:user。contentarray (必須)メッセージ内容の配列。1 つのテキストオブジェクトを含む必要があります。
プロパティ text string(必須)希望する内容、スタイル、構図を記述するポジティブプロンプト。中国語および英語をサポートします。最大 800 文字(文字、アルファベット、数字、記号のいずれも 1 文字としてカウント)です。超過分は切り捨てられます。例:幸せそうな表情をした座っているオレンジ色の猫。生き生きとして可愛らしく、リアルで正確。注記:テキストオブジェクトは 1 つのみサポートされます。ゼロ個または複数のテキストオブジェクトを渡すとエラーが返されます。object (任意)画像生成パラメーター。
プロパティ size string (任意)出力画像の解像度を幅×高さ形式で指定します。
合計ピクセル数が 1024*1024 の推奨解像度:
合計ピクセル数が 1280*1280 の推奨解像度:
合計ピクセル数が 1536*1536 の推奨解像度:
bool (任意)LLM による最適化と推論出力を通じて、インテリジェントなプロンプトリライトを有効にします。
integer (任意)乱数シード。有効範囲:[0,2147483647]。同じ seed を使用すると、類似した出力が得られます。省略した場合、アルゴリズムはランダムなシードを使用します。注記:画像生成は確率的です。同じ seed を使用しても、結果が異なる場合があります。 |
この例では、より高速な応答のために画像を直接返します。インテリジェントなプロンプトリライトを有効にするには、 prompt_extend=true を設定してください。この場合、システムは最適化されたプロンプト、推論内容、および画像を返します(応答時間が長くなります)。 |
レスポンスパラメーターoutputobjectモデルの出力。
プロパティ choices arrayモデルの出力内容。配列には 1 つの要素が含まれます。
プロパティ finish_reason string完了理由。stop の値は成功を示します。message objectモデルの応答メッセージ。
プロパティ role stringメッセージのロール。値は assistant です。contentarray
プロパティ image string生成された画像の URL (PNG)。24 時間有効です。速やかにダウンロードしてください。text stringこれは、入力プロンプト (prompt_extend=false の場合) または書き直されたプロンプト (prompt_extend=true の場合) を返します。stringモデルの推論プロセス。prompt_extend=true の場合にのみ返されます。objectこれは、正常に生成された場合の使用量統計情報のみを含みます。
プロパティ width integer生成された画像の幅 (ピクセル)。height integer生成された画像の高さ (ピクセル)。image_count integer生成された画像の枚数:1。input_tokens integer入力トークン数 (prompt_extend=false の場合は 0)。output_tokens integer出力トークン数 (prompt_extend=false の場合は 0)。output_tokens_detailsobject出力トークンの詳細 (prompt_extend=true の場合のみ)。
プロパティ reasoning_tokens integer推論に使用されるトークン。integer合計トークン数 (prompt_extend=false の場合は 0)。stringトレースおよびトラブルシューティング用の一意のリクエスト識別子。code stringエラーコード。失敗したリクエストの場合にのみ返されます。エラーコードをご参照ください。message string詳細なエラーメッセージ。失敗したリクエストの場合にのみ返されます。エラーコードをご参照ください。 |
タスクデータ(タスクステータスおよび画像 URL)は 24 時間のみ保持され、その後自動的に消去されます。生成された画像は速やかに保存してください。 |
制限事項
- 画像 URL の有効期限は 24 時間です。速やかにダウンロードしてください。
- コンテンツモデレーション:入力
プロンプトおよび出力画像の両方がコンテンツモデレーションの対象となります。準拠していないコンテンツの場合、IPInfringementSuspectまたはDataInspectionFailedエラーが返されます。エラーコードをご参照ください。
課金とレート制限
- 価格と無料クォータについては、モデルの課金をご参照ください。
- レート制限については、Z-Imageをご参照ください。
- 課金は、正常に生成された画像の枚数および prompt_extend の状態に基づいて行われます。失敗した呼び出しは料金が発生せず、無料クォータも消費しません。
