Z-Image は、高速に画像を生成できる軽量なテキストから画像への変換モデルであり、中国語および英語のテキストレンダリングをサポートし、さまざまな解像度および縦横比に対応しています。
クイックアクセス:オンライン体験 (シンガポール | 中国 (北京)) | 技術ブログ
サンプル画像
入力プロンプト | 出力画像 |
短い黒髪のスタイリッシュな若い女性が、鮮やかな漫画風の壁画の壁の前で自信を持って立っている写真。全身黒の装い:ふわっとしたボンバージャケット(レースの襟付き)、カーゴショーツ、フィッシュネットタイツ、厚底の黒いドクマーテンズを履き、腰からゴールドチェーンが垂れています。背景には、カラフルなコミック風のパネルが4つあり、1つは「GRAND STAGE」と記載されており、スニーカーとゲータレードのボトルが描かれています。2つ目は、緑色のナイキスニーカーとピザのスライスが描かれています。3つ目は「HARAJUKU st」と記載されており、浮遊する靴が描かれています。4つ目は、スケートボードに乗った青いマウスが「Takeshita WELCOME.」というテキストとともに描かれています。主な明るい色は黄色、ターコイズ、オレンジ、ピンク、緑です。吹き出し、ハーフトーンパターン、遊び心のあるキャラクターが都会的なストリートアートの美学を高めています。日中の光が均等にシーンを照らしており、足元の地面は白いタイル張りの舗装です。全身ポートレート、中央構図、やや傾いた立ち姿、カメラとのアイコンタクト。高精細、シャープなフォーカス、ダイナミックなフレーミング。 |
|
モデル概要
モデル名 | モデル説明 | 出力画像仕様 |
z-image-turbo | 軽量モデルで、画像を高速に生成します | 画像解像度:合計ピクセル数は 512×512 ~ 2048×2048 の範囲です。推奨解像度については、「size パラメーター設定」をご参照ください。 画像フォーマット:PNG 画像枚数:固定で 1 枚 |
API を呼び出す前に、各リージョンでサポートされているモデル一覧をご確認ください。
前提条件
API キーを取得し、API キーを環境変数として設定します(今後非推奨となり、「API キーの設定」に統合されます)。
同期 HTTP 呼び出し
シンガポールリージョン:POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
中国 (北京) リージョン:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
リクエストパラメーター | テキストから画像への変換この例では、画像を直接返し、高速な応答時間を実現します。 インテリジェントな推論を有効にするには、 |
リクエストヘッダー | |
Content-Type リクエストのコンテンツタイプ。必ず | |
Authorization Model Studio API キーを使用した認証資格情報。 例: | |
リクエスト本文 | |
model モデル名。必ず z-image-turbo を指定してください。 | |
input 基本的な入力情報。 | |
parameters 画像編集パラメーター。 |
レスポンスパラメーター | タスク実行成功時タスクデータ(タスクステータスおよび画像 URL)は 24 時間のみ保持され、その後自動的にパージされます。生成された画像は速やかに保存してください。 タスク実行失敗時タスクの実行に失敗した場合、エラーの詳細を含むレスポンスが返されます。code および message フィールドが失敗の原因を示します。詳細については、「エラーメッセージ」をご参照ください。 |
output タスクの出力情報。 | |
usage 出力使用状況の統計情報。成功した結果のみがカウントされます。 | |
request_id リクエストの一意の識別子。トレーシングおよびトラブルシューティングに使用します。 | |
code エラーコード。リクエストが失敗した場合のみ返されます。「エラーコード」をご参照ください。 | |
message 詳細なエラーメッセージ。リクエストが失敗した場合のみ返されます。「エラーコード」をご参照ください。 |
制限事項
画像の
urlは 24 時間のみ保持されます。速やかにダウンロードしてください。コンテンツモデレーション:入力
promptおよび出力画像の両方がコンテンツモデレーションの対象となります。禁止されたコンテンツを含むリクエストは、IPInfringementSuspectまたはDataInspectionFailedエラーを引き起こします。「エラーコード」をご参照ください。
課金およびレート制限
エラーコード
モデル呼び出しが失敗してエラーメッセージを返した場合、「エラーメッセージ」をご参照ください。
よくある質問
Q:モデル呼び出しのメトリックを確認するにはどうすればよいですか?
A:モデル呼び出しの完了から 1 時間後、モデルモニタリング(シンガポール) または モデルモニタリング(中国 (北京)) ページに移動して、呼び出し回数や成功率などのメトリックを確認できます。詳細については、「課金照会およびコスト管理」をご参照ください。
Q:画像ストレージ用のドメイン名ホワイトリストを取得するにはどうすればよいですか?
A:モデルによって生成された画像は OSS に保存されます。API は一時的なパブリック URL を返します。このダウンロード URL 用のファイアウォールホワイトリストを設定するには、以下の点にご注意ください。基盤となるストレージは動的に変更される可能性があります。このトピックでは、古くなった情報によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御が必要な場合は、アカウントマネージャーに連絡して、最新の OSS ドメイン名リストを取得してください。
