Alibaba Cloud Model Studio:Wan2.7 - テキスト動画生成 API リファレンス

リクエスト例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# シンガポールリージョンの URL。URL はリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference をご参照ください。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合は、Model Studio の API キーに置き換えてください：api_key="sk-xxx"。
# API キーはリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/get-api-key をご参照ください。
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_sync_call_t2v():
    # 同期 API を呼び出し、結果を返します。
    print('お待ちください...')
    rsp = VideoSynthesis.call(api_key=api_key,
                              model='wan2.6-t2v',
                              prompt="Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them.'",
                              audio_url='https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3',
                              size='1280*720',
                              duration=10,
                              negative_prompt="",
                              prompt_extend=True,
                              watermark=False,
                              seed=12345)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed. Status code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call_t2v()

レスポンス例

video_url は 24 時間後に期限切れになります。速やかにダウンロードしてください。

{
    "status_code": 200,
    "request_id": "167f3beb-3dd0-47fe-a83c-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "5b65411f-d946-4e29-859e-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-bj.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
        "submit_time": "2025-10-23 11:47:23.879",
        "scheduled_time": "2025-10-23 11:47:34.351",
        "end_time": "2025-10-23 11:52:35.323",
        "orig_prompt": "ローアングルからのショット、ミディアムクローズアップ、暖色系のトーン、混合照明 (デスクランプの光が窓からの曇り空の光と混ざり合っている)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑色のデスクランプが、机の中央に広げられた事件ファイルを照らしている。ダークブラウンのトレンチコートとライトグレーのフェドーラ帽を身に着けたキツネが革張りの椅子に座っている。その毛皮は深紅色で、尻尾は端に軽く置かれ、指でゆっくりと黄ばんだページをめくっている。外では、青空の下で霧雨が絶え間なく降り、ガラスに蛇行する筋を残している。キツネはゆっくりと顔を上げ、耳をわずかにひくつかせ、琥珀色の目でカメラをまっすぐ見つめ、滑らかで皮肉な声で、口をはっきりと動かしながら話す。「事件は冷え切っていた、冬の魚よりも冷たく。だが、どんな鶏にも秘密はある。そして、私としては、それらを見つけ出すつもりだった 」。"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 10,
        "size": "1280*720",
        "input_video_duration": 0,
        "output_video_duration": 10,
        "SR": 720
    }
}

リクエスト例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# これはシンガポールリージョンの URL です。URL はリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference をご参照ください。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合は、これを Model Studio の API キーに置き換えてください：api_key="sk-xxx"
# API キーはリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/get-api-key をご参照ください。
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_async_call_t2v():
    # 非同期 API を呼び出し、タスク情報を返します。
    # タスク ID を使用してステータスを確認します。
    rsp = VideoSynthesis.async_call(api_key=api_key,
                                    model='wan2.6-t2v',
                                    prompt="Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '.",
                                    audio_url='https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3',
                                    size='1280*720',
                                    duration=10,
                                    negative_prompt="",
                                    prompt_extend=True,
                                    watermark=False,
                                    seed=12345)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print("task_id: %s" % rsp.output.task_id)
    else:
        print('Failed. Status code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))
                           
    # タスク情報 (タスクステータスを含む) を取得します。
    status = VideoSynthesis.fetch(task=rsp, api_key=api_key)
    if status.status_code == HTTPStatus.OK:
        print(status.output.task_status)  # タスクステータスを確認します。
    else:
        print('Failed. Status code: %s, code: %s, message: %s' %
              (status.status_code, status.code, status.message))

    # タスクが完了するまで待ちます。このメソッドは fetch を間隔を置いて呼び出し、タスクが完了状態にあるか確認します。
    rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed. Status code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_async_call_t2v()

レスポンス例

1. タスク作成レスポンス例

   {
   	"status_code": 200,
   	"request_id": "c86ff7ba-8377-917a-90ed-xxxxxx",
   	"code": "",
   	"message": "",
   	"output": {
   		"task_id": "721164c6-8619-4a35-a6d9-xxxxxx",
   		"task_status": "PENDING",
   		"video_url": ""
   	},
   	"usage": null
   }

2. タスククエリレスポンス例

   video_url は 24 時間後に期限切れになります。速やかにダウンロードしてください。

   {
       "status_code": 200,
       "request_id": "167f3beb-3dd0-47fe-a83c-xxxxxx",
       "code": null,
       "message": "",
       "output": {
           "task_id": "5b65411f-d946-4e29-859e-xxxxxx",
           "task_status": "SUCCEEDED",
           "video_url": "https://dashscope-result-bj.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
           "submit_time": "2025-10-23 11:47:23.879",
           "scheduled_time": "2025-10-23 11:47:34.351",
           "end_time": "2025-10-23 11:52:35.323",
           "orig_prompt": "ローアングル、ミディアムクローズアップ、暖色系のトーン、混合照明 (デスクランプからの実用的な光と窓からの曇り空の光が混ざり合う)、サイドライティング、中央構図で撮影。クラシックな探偵事務所。木製の本棚には古い事件ファイルと灰皿がぎっしり詰まっている。緑色のデスクランプが、机の中央に広げられた事件ファイルを照らしている。ダークブラウンのトレンチコートとライトグレーのフェドーラ帽をかぶったキツネが革製の椅子に座っている。毛皮は深紅色で、尻尾は端に軽く置かれ、指は黄ばんだページをゆっくりとめくっている。外では青空の下で霧雨が絶え間なく降り、ガラスに曲がりくねった筋をつけている。キツネはゆっくりと頭を上げ、耳をわずかにぴくぴくさせ、琥珀色の目でカメラをまっすぐ見つめる。滑らかで皮肉な声で話すと、口がはっきりと動く。「事件は冷え切っていた、冬の魚よりも冷たい。だが、どんな鶏にだって秘密はある。そして、この私は、それを見つけ出すつもりだった。」"
       },
       "usage": {
           "video_count": 1,
           "video_duration": 0,
           "video_ratio": "",
           "duration": 10,
           "size": "1280*720",
           "input_video_duration": 0,
           "output_video_duration": 10,
           "SR": 720
       }
   }

リクエスト例

// Copyright (c) Alibaba, Inc. and its affiliates.

// dashscope SDK バージョン 2.18.2 以降
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.util.HashMap;
import java.util.Map;

public class Text2Video {

    static {
        // シンガポールリージョンの URL。URL はリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference をご参照ください。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }
    
    // 環境変数が設定されていない場合は、値を Model Studio の API キーに置き換えてください：apiKey = "sk-xxx"。
    // API キーはリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/get-api-key をご参照ください。
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("seed", 12345);

        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.6-t2v")
                        .prompt("Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: ''The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them ''.")
                        .audioUrl("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3")
                        .negativePrompt("")
                        .size("1280*720")
                        .duration(10)
                        .parameters(parameters)
                        .build();
        System.out.println("お待ちください...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

レスポンス例

video_url は 24 時間後に期限切れになります。速やかにダウンロードしてください。

{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "成功",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
        "orig_prompt": "ローアングルからのショット、ミディアムクローズアップ、暖色系のトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、そして中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が並んでいる。緑色のデスクランプが、机の中央に広げられた事件ファイルを照らしている。ダークブラウンのトレンチコートとライトグレーのフェドーラ帽をかぶったキツネが、革張りの椅子に座っている。その毛皮は深紅色で、尻尾は端に軽く置かれ、指で黄ばんだページをゆっくりとめくっている。外では、青空の下で霧雨が降り続き、ガラスに蛇行する筋を残している。キツネはゆっくりと頭を上げ、耳をわずかにひくつかせ、琥珀色の瞳でカメラをまっすぐ見つめる。滑らかで皮肉な声で話すとき、口がはっきりと動いている。『事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私としては、それらを見つけ出すつもりだった』",
        "submit_time": "2026-01-22 23:13:40.553",
        "scheduled_time": "2026-01-22 23:13:49.415",
        "end_time": "2026-01-22 23:17:56.380"
    },
    "usage": {
        "video_count": 1,
        "duration": 10.0,
        "size": "1280*720",
        "input_video_duration": 0.0,
        "output_video_duration": 10.0,
        "SR": "720"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

リクエスト例

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisListResult;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.util.HashMap;
import java.util.Map;

public class Text2Video {
    static {
        // シンガポールリージョンの URL。URL はリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference をご参照ください。
        Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

     // 環境変数が設定されていない場合は、プレースホルダーを Model Studio の API キーに置き換えてください。例：apiKey="sk-xxx"
    // API キーはリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/en/model-studio/get-api-key をご参照ください。
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("seed", 12345);

        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.6-t2v")
                        .prompt("Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: ''The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them ''.")
                        .audioUrl("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3")
                        .negativePrompt("")
                        .size("1280*720")
                        .duration(10)
                        .parameters(parameters)
                        .build();

        // 非同期呼び出しを行います。
        VideoSynthesisResult task = vs.asyncCall(param);
        System.out.println(JsonUtils.toJson(task));
        System.out.println("お待ちください...");

        // 結果を取得します。
        VideoSynthesisResult result = vs.wait(task, apiKey);
        System.out.println(JsonUtils.toJson(result));
    }

     // タスクリストを取得します。
    public static void listTask() throws ApiException, NoApiKeyException {
        VideoSynthesis is = new VideoSynthesis();
        AsyncTaskListParam param = AsyncTaskListParam.builder().build();
        param.setApiKey(apiKey);
        VideoSynthesisListResult result = is.list(param);
        System.out.println(result);
    }

    // 単一タスクの結果を取得します。
    public static void fetchTask(String taskId) throws ApiException, NoApiKeyException {
        VideoSynthesis is = new VideoSynthesis();
        // DASHSCOPE_API_KEY 環境変数を設定した場合、apiKey は null に設定できます。
        VideoSynthesisResult result = is.fetch(taskId, apiKey);
        System.out.println(result.getOutput());
        System.out.println(result.getUsage());
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

レスポンス例

1. タスク作成レスポンス例。

   {
           "request_id": "5dbf9dc5-4f4c-9605-85ea-xxxxxxxx",
   	"output": {
   		"task_id": "7277e20e-aa01-4709-xxxxxxxx",
   		"task_status": "PENDING"
   	}
   }

2. タスククエリレスポンス例

   video_url は 24 時間後に期限切れになります。速やかにダウンロードしてください。

   {
       "request_id": "c1209113-8437-424f-a386-xxxxxx",
       "output": {
           "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
           "task_status": "SUCCEEDED",
           "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
           "orig_prompt": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: ''The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them ''",
           "submit_time": "2026-01-22 23:13:40.553",
           "scheduled_time": "2026-01-22 23:13:49.415",
           "end_time": "2026-01-22 23:17:56.380"
       },
       "usage": {
           "video_count": 1,
           "duration": 10.0,
           "size": "1280*720",
           "input_video_duration": 0.0,
           "output_video_duration": 10.0,
           "SR": "720"
       },
       "status_code": 200,
       "code": "",
       "message": ""
   }