Skip to main content

Vidu-Image生成APIリファレンス

Vidu画像生成モデルは、テキストから画像、画像編集、および参照画像から画像のタスクをサポートしています。

モデルの概要

モデル

機能

入力モダリティ

出力画像仕様

vidu/vidu-image_reference2image

参照画像生成、テキストから画像、画像編集。中国語と英語のテキストの正確なレンダリング、UI/チャートおよびデザインの詳細のピクセルレベルの復元。ポスター、インフォグラフィックなどに最適です。

テキスト、画像

解像度：1K、2K、4K

画像数：1

画像形式：PNG

前提条件

  1. サービスの有効化: Model Studioコンソールに移動し、「Vidu」を検索して、対応するモデルカードを見つけ、Activate Nowをクリックしてポップアップウィンドウで有効化と承認を確認します。
  2. API Key の設定：リージョンを選択し、API キーを取得します。

HTTP 呼び出し

画像生成タスクには一定の時間がかかるため、APIは非同期呼び出しを使用します。プロセスは、次のように「タスクの作成 -> 結果のポーリング」という2つのコアステップで構成されています。

ステップ 1：画像生成タスクの送信

シンガポールリージョン: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation

リクエストパラメータ

ヘッダー
Content-Type string （必須）リクエストのコンテンツタイプ。application/json である必要があります。Authorization string （必須）Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。X-DashScope-Async string （必須）非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable である必要があります。
このリクエストヘッダーがない場合、「current user api does not support synchronous calls」というエラーが返されます。
リクエストボディ
model string （必須）モデル名。利用可能な値：
  • vidu/vidu-image_reference2image
input object （必須）以下のフィールドを含む入力パラメータオブジェクト：

プロパティ

messages array （必須）メッセージリスト。サーバーは、空でない最初のtextをプロンプトとして抽出し、すべてのimageフィールドを参照画像として抽出します。配列には、roleプロパティとcontentプロパティを持つちょうど1つのオブジェクトが含まれます。

プロパティ

rolestring（任意）メッセージのロール。推奨値：user。contentarray （必須）メッセージコンテンツ。テキストプロンプト（text）とオプションの参照画像（image、複数サポート）を含みます。

プロパティ

textstring（条件付き必須）希望する画像のコンテンツ、スタイル、構図を記述するポジティブプロンプト。中国語と英語の両方をサポートしています。最大長は5,000文字で、各文字（中国語、英字、数字、または記号）は1文字としてカウントされます。例：幸せそうな表情をした座っているオレンジ色の猫、生き生きとしていて可愛らしく、リアルで正確。注意：メッセージには少なくとも 1 つの空でないテキストが必要です。image string（任意）参照画像の URL。複数の画像がサポートされています。すべてのモデルで最大 14 枚の参照画像がサポートされています。画像の制約：
  • 形式：PNG、JPG、WEBP。
  • アスペクト比：1:4 から 4:1 の間。
  • ファイルサイズ：すべての画像の合計サイズは 50 MB を超えてはなりません。
  • 数量：最大 14 枚の参照画像。
parameters object（任意）画像生成パラメータ。

プロパティ

size string（任意）width*height 形式の画像サイズ（例：2048*2048）。指定しない場合のデフォルトは 1024*1024 です。モデルごとにサポートされているサイズの一覧については、以下のサポートされている画像サイズセクションを参照してください。n integer（任意）生成する画像の数。現在、1 のみがサポートされています。他の値を指定するとパラメータエラーが返されます。seed integer（任意）乱数シード。有効な範囲：[0,2147483647]。0 はランダムを意味します。同じ seed を使用すると、同様の出力が得られます。省略した場合、アルゴリズムはランダムシードを使用します。watermark bool（任意）ウォーターマークを追加するかどうか。
  • false：デフォルト。ウォーターマークなし。
  • true：ウォーターマークを追加。
  • テキストから画像
  • 参照画像から画像
すべての Vidu モデルでサポートされています。
# Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "vidu/vidu-image_reference2image",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "A flower shop with exquisite windows, a beautiful wooden door, displaying flowers"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1,
        "watermark": false
    }
}'

レスポンスパラメータ

request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。エラーコードを参照してください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。エラーコードを参照してください。
  • 成功レスポンス
  • エラーレスポンス
タスクのステータスと結果をクエリするには、task_id を保存してください。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 2：タスク結果のクエリ

シンガポールリージョン: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • ポーリングの推奨事項: 画像生成には時間がかかります。結果を取得するには、適切なクエリ間隔（例: 5秒）でポーリングメカニズムを使用することをお勧めします。
  • タスクのステータスフロー: PENDING (待機中) → RUNNING (処理中) → SUCCEEDED (成功) / FAILED (失敗)。
  • 画像リンクの有効期間: 生成された画像のダウンロードリンクの有効期間は24時間です。画像を速やかにダウンロードして保存してください。

リクエストパラメータ

ヘッダー
Authorization string （必須）Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。task_id string （必須）タスクの ID。
  • タスク結果のクエリ
# Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
curl --location --request GET 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメータ

output objectタスク出力情報。

プロパティ

task_id stringタスク ID。choices array画像出力候補リスト。task_status=SUCCEEDED の場合にのみ返されます。

プロパティ

finish_reason string完了の理由。通常、成功時は stop です。message objectモデルから返されるメッセージ。

プロパティ

rolestringメッセージのロール。assistant に固定されています。contentarray

プロパティ

type string出力コンテンツのタイプ。image に固定されています。image stringPNG形式の生成画像のダウンロードリンク。リンクの有効期間は24時間です。画像を速やかにダウンロードして保存してください。
finished boolタスクが完了したかどうか。task_status=SUCCEEDED の場合にのみ返されます。
usage objectリソース使用情報。成功した結果のみをカウントします。

プロパティ

image_count integer生成される画像の数。size string生成された画像の解像度（width*height 形式）。例：2048*2048。SR string生成された画像の解像度ティア。例：2K。
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。エラーコードを参照してください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。エラーコードを参照してください。
  • タスク成功
  • タスク失敗
{
    "request_id": "f584a817-6e00-9841-961a-49f7382a03d4",
    "output": {
        "task_id": "6404d4ec-4cdf-45b5-8d7d-3d429c6baed5",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-07-13 20:27:41.291",
        "scheduled_time": "2026-07-13 20:27:41.320",
        "end_time": "2026-07-13 20:28:39.767",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://example.com/generated-image.png",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "SR": "2K",
        "size": "2048*2048",
        "image_count": 1
    }
}

エラーコード

モデルの呼び出しに失敗してエラーメッセージが返された場合は、解決方法についてエラーコードを参照してください。

サポートされている画像サイズ

vidu-image

解像度

サポートされているサイズ

1K

1024*1024, 720*1440, 1440*720, 1024*768, 768*1024, 1920*1088, 1088*1920, 1536*1024, 1024*1536, 1920*816, 816*1920

2K

2048*2048, 1088*2160, 2160*1088, 2736*2048, 2048*2736, 2560*1440, 1440*2560, 3072*2048, 2048*3072, 2560*1104, 1104*2560

4K

2880*2880, 1440*2880, 2880*1440, 3312*2480, 2480*3312, 3840*2160, 2160*3840, 3520*2352, 2352*3520, 3840*1648, 1648*3840