すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:動画スタイル変換 API リファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:動画スタイル変換 API リファレンス

    最終更新日:Oct 31, 2025

    動画スタイル変換 API は、入力された動画を様々な定義済みのアートスタイルに変換し、滑らかで自然な動きを再現すると同時に、コンテンツの一貫性も確保できます。この API は、日本漫画、アメリカンコミック、フレッシュコミック、3D カートゥーン、中国風カートゥーン、ペーパーアートスタイル、シンプルなイラスト、水墨画風の 8 種類のスタイルをサポートしています。

    重要

    このモデルサービスは、中国 (北京) リージョンでのみ利用可能です。API を呼び出すには、このリージョンの API キーが必要です。

    実行例

    変換前

    変換後 (アートスタイル：日本漫画)

    その他の例については、「付録: その他のスタイルの変換効果」をご参照ください。

    前提条件

    API を呼び出す前に、API キーを取得し、環境変数として設定してください。

    HTTP

    動画の処理には時間がかかります。リクエストのタイムアウトを防ぐため、動画スタイル変換では非同期呼び出しを使用します。処理は次の 2 段階で構成されます。

    1. 非同期タスクの送信：ソース動画の URL と希望するスタイルパラメーターを指定して POST リクエストを送信し、一意の task_id を取得します。

    2. タスク結果の照会：task_id を使用して GET リクエストでタスクステータスをポーリングし、タスク完了後に生成された動画の URL を取得します。

    ステップ 1: 動画スタイル変換タスクの送信

    POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

    リクエスト

    720p 動画の生成
    curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "video-style-transform",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250704/viwndw/original_video.mp4"
    },
    "parameters": {
        "style": 0,
        "video_fps": 15
    }
}'
    import requests
import os


DASHSCOPE_API_KEY = os.getenv("DASHSCOPE_API_KEY")
# 実際の動画 URL に置き換えてください
video_url = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250704/viwndw/original_video.mp4"

response = requests.post(
            "https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis",
            headers={
                "Authorization": f"Bearer {DASHSCOPE_API_KEY}",
                "X-DashScope-Async": "enable",
            },
            json={
            "model": "video-style-transform",
            "input": {
                "video_url": video_url
            },
            "parameters": {
                "style": 0,
                "video_fps": 15
            }
        }
        )
print(response.json())
    540p 動画の生成
    curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "video-style-transform",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250704/viwndw/original_video.mp4"
    },
    "parameters": {
        "style": 0,
        "video_fps": 15,
        "min_len": 540
    }
}'
    import requests
import os


DASHSCOPE_API_KEY = os.getenv("DASHSCOPE_API_KEY")
# この部分を実際の動画 URL に置き換えてください
video_url = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250704/viwndw/original_video.mp4"

response = requests.post(
            "https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis",
            headers={
                "Authorization": f"Bearer {DASHSCOPE_API_KEY}",
                "X-DashScope-Async": "enable",
            },
            json={
            "model": "video-style-transform",
            "input": {
                "video_url": video_url
            },
            "parameters": {
                "style": 0,
                "video_fps": 15,
                "min_len": 540
            }
        }
        )
print(response.json())
    ヘッダー

    Content-Type string (必須)

    リクエストのコンテンツタイプです。application/json に設定する必要があります。

    Authorization string (必須)

    リクエストの認証情報です。この API は Model Studio API キーを使用して認証を行います。例: Bearer sk-xxxx

    X-DashScope-Async string (必須)

    非同期処理の設定パラメーターです。HTTP リクエストは非同期処理のみをサポートしているため、このパラメーターを enable に設定する必要があります。

    重要

    このリクエストヘッダーがない場合、「current user api does not support synchronous calls」というエラーメッセージが返されます。

    リクエストボディ

    model string (必須)

    モデル名です。video-style-transform に設定します。

    input object (必須)

    入力コンテンツです。

    プロパティ

    video_url string (必須)

    入力動画の URL です。例: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250704/viwndw/original_video.mp4

    入力動画の要件:

    • 解像度: 動画の各辺の長さは 256 ピクセルから 4096 ピクセルの間である必要があります。長辺と短辺の縦横比は 1.8 を超えないようにしてください。

    • ファイル形式：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF

    • 長さ：30 秒以下

    • サイズ：100 MB 以下

    • URL：元の URL に日本語などの非 ASCII 文字がある場合は、まず URL エンコードを行ってください。

    parameters object (任意)

    動画処理パラメーターです。

    プロパティ

    style int (任意)

    スタイルタイプです。定義済みのタイプは次のとおりです。

    • 0: 日本漫画 (デフォルト)

    • 1: アメリカンコミック

    • 2: フレッシュコミック

    • 3: 3D カートゥーン

    • 4: 中国漫画 (古装の入力に最適)

    • 5: ペーパーアートスタイル

    • 6: シンプルなイラスト

    • 7: 水墨画風

    video_fps int (任意)

    生成される動画のフレームレートです。デフォルト値は 15 です。有効な範囲は [15,25] です。

    animate_emotion bool (任意)

    顔の表情を加工するかどうかを指定します。デフォルト値は true です。

    このオプションを有効にすると、口元と表情がより自然に連動するようになります。顔が画面全体に占める割合が低い場合、このオプションを無効にすることを推奨します。

    min_len int (任意)

    出力動画の短辺のピクセル数を指定し、解像度を制御します。指定可能な値は 720 と 540 で、デフォルト値は 720 です。

    説明

    選択する値に応じて料金が異なります。720p で出力された動画は、 540p の動画よりコストが高くなります。詳細については、「課金とレート制限」をご参照ください。

    use_SR bool (任意)

    スタイル変換後、動画へ超解像技術 (Super-Resolution, SR) 処理を適用するかどうかを指定します。デフォルト値は false です。これを true に設定すると、追加料金なしで動画の品質を向上させることができます。

    説明

    min_len が 540 に設定された場合、このオプションを有効にすると、540p 画質の料金で 1080p 画質を出力できます。ただし、処理時間が増加するため、高画質での出力が必要な場合にのみ有効にすることを推奨します。

    レスポンス

    正常なレスポンス
    {
    "output": {
	  "task_id": "xxxxxxxx", 
    	  "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}
    異常なレスポンス
    {
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxxxxxxxx"
}

    output object

    タスクの出力情報です。

    プロパティ

    task_id string

    非同期タスクの一意の ID です。この ID は後続のクエリに使用されます。

    task_status string

    タスクのステータスです。

    • PENDING：実行待ち

    • RUNNING：実行中

    • SUSPENDED：中断

    • SUCCEEDED：実行完了

    • FAILED：実行失敗

    request_id string

    一意のリクエスト ID です。この ID を使用して、問題を追跡し、トラブルシューティングを行うことができます。

    code string

    失敗したリクエストのエラーコードです。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    message string

    失敗したリクエストの詳細情報です。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    ステップ 2: タスクステータスと結果のクエリ

    GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
    重要

    タスクステータスや生成された動画の URL などのタスク結果データは 24 時間有効です。この期間が過ぎると、データは自動的に消去されます。有効期間内に結果を照会し、保存してください。

    リクエスト

    タスク結果の取得

    {task_id} を実際の task_id に置き換える必要があります。

    curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
    import requests
import os

DASHSCOPE_API_KEY = os.getenv("DASHSCOPE_API_KEY")
# task_id を実際の task_id に置き換えてください
task_id = "0c9c33e6-b2e7-41e5-*********"

task_response = requests.get(
        f"https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}",
        headers={
            "Authorization": f"Bearer {DASHSCOPE_API_KEY}"
        })
print(task_response.json())
    ヘッダー

    Authorization string (必須)

    リクエストの認証情報です。この API は Model Studio API キーを使用して認証を行います。例: Bearer sk-xxxx

    パスパラメーター

    task_id string (必須)

    タスク ID です。

    レスポンス

    実行完了
    {
    "request_id": "b67df059-ca6a-9d51-afcd-xxxxxxxxxxxx",
    "output": {
        "task_id": "d76ec1e8-ea27-4038-8913-xxxxxxxxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2024-05-16 13:50:01.247",
        "scheduled_time": "2024-05-16 13:50:01.354",
        "end_time": "2024-05-16 13:50:27.795",
        "output_video_url": "http://xxx/result.mp4"
    },
    "usage": {
        "duration": 3,
        "SR": 720 
    }
}
    実行中

    タスクが送信されると、キューイング状態となります。スケジュールされると、実行状態に移行し、この時点でのステータスは RUNNING に変わります。

    {
    "request_id":"e5d70b02-ebd3-98ce-9fe8-xxxxxxxxxxxx",
    "output":{
        "task_id":"13b1848b-5493-4c0e-xxxxxxxxxxxx",
        "task_status":"RUNNING",
        "submit_time":"2025-09-08 15:53:13.143",
        "scheduled_time":"2025-09-08 15:53:13.169"
    }
}
    実行失敗
    {
    "request_id": "dccfdf23-b38e-97a6-a07b-xxxxxxxxxxxx",
    "output": {
        "task_id": "4cbabbdf-2c1f-43f4-b983-xxxxxxxxxxxx",
        "task_status": "FAILED",
        "submit_time": "2024-05-16 14:15:14.103",
        "scheduled_time": "2024-05-16 14:15:14.154",
        "end_time": "2024-05-16 14:15:14.694",
        "code": "InvalidParameter.FileDownload",
        "message": "download for input video error"
    }
}

    request_id string

    リクエストの一意の ID です。この ID を使用してリクエストの詳細を追跡し、トラブルシューティングを行うことができます。

    output object

    タスクの出力情報です。

    プロパティ

    output_video_url string

    生成された動画の URL です。例: http://xxx/result.mp4

    task_id string

    タスク ID です。クエリは 24 時間有効です。

    task_status string

    タスクのステータスです。

    • PENDING：実行待ち

    • RUNNING：実行中

    • SUSPENDED：中断

    • SUCCEEDED：実行完了

    • FAILED：実行失敗

    • UNKNOWN：タスクが存在しないか、ステータスが不明です。

    submit_time string

    タスクが送信された時刻です。形式：YYYY-MM-DD HH:mm:ss.SSS

    scheduled_time string

    タスクが実行を開始した時刻です。形式：YYYY-MM-DD HH:mm:ss.SSS

    end_time string

    タスクが完了した時刻です。形式：YYYY-MM-DD HH:mm:ss.SSS

    code string

    失敗したリクエストのエラーコードです。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    message string

    失敗したリクエストの詳細情報です。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    usage object

    タスクの使用状況統計です。

    プロパティ

    duration float

    生成された動画の長さ (秒) です。

    SR int

    課金に使用される動画の短辺のピクセル値です。この値は、リクエストで設定した min_len の値と同じです。

    課金とレート制限

    成功したタスクに対してのみ課金されます。料金は、出力動画の実際の長さ (秒) と選択した解像度に基づいて計算されます。

    課金計算式： 合計料金 = 出力動画の長さ (秒) × 対応する解像度の単価 (注意：最終的な料金は、成功したタスクに対して返される usage オブジェクト内の duration および SR フィールドに基づいて計算されます)

    モデル

    単価

    レート制限 (Alibaba Cloud アカウントと RAM ユーザーで共有)

    タスク送信 API の QPS 制限

    同時実行タスク数

    video-style-transform

    720p

    $0.071677/秒

    2

    1

    540p

    $0.028671/秒

    課金例

    たとえば、10 秒の動画を送信し、スタイル変換に 720p の解像度を選択したとします。タスクが成功し、生成された動画の長さが 10 秒の場合、このタスクの料金は 10 秒 × $0.071677/秒 = $0.71677 です。

    エラーコード

    呼び出しが失敗した場合のトラブルシューティングについては、「エラーメッセージ」をご参照ください。

    付録: その他のスタイルの変換効果

    スタイル

    変換前

    変換後

    日本漫画 (style=0)

    アメリカンコミック (style=1)

    フレッシュコミック (style=2)

    3D カートゥーン (style=3)

    中国漫画 (style=4)

    ペーパーアートスタイル (style=5)

    シンプルなイラスト (style=6)

    水墨画風 (style=7)