功能简介

CloudVideoGenerate 是聚合视频生成服务，基于阿里云百炼大模型，提供文生视频、图生视频等 AI 视频生成能力。输入一段文字描述（prompt），即可生成与描述相匹配的高质量视频。

适用场景

• 短视频创作：快速生成短视频素材
• 创意广告：生成广告宣传视频
• 内容营销：为内容创作提供视频素材
• 图生视频：将静态图片动态化

功能特性

• 多种模型：内置万相 2.1、万相 2.7 等多个视频生成模型
• 文生视频：根据文字描述生成视频
• 图生视频：基于一张或多张图片生成动态视频
• 参数配置：支持分辨率、宽高比、时长等参数自定义
• 时长说明：万相 2.1 系列生成时长固定（5 秒），万相 2.7 系列支持自定义时长（2-15 秒）
• 异步处理：提交任务后轮询获取生成结果
• 点数计费：按模型配置动态计费（点/秒）

资费标准

• 文生视频 / 图生视频：按模型实际价格计费，单位为「点/秒」

1. 接口基础

使用前请阅读 接口基础 。

2. 任务提交（异步）

请求地址

[POST] https://api.tecmz.com/open_api/cloud_video_generate/queue

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 任务ID
        "taskId": "1"
    }
}

3. 任务查询

请求地址

[POST] https://api.tecmz.com/open_api/cloud_video_generate/query

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 任务状态：QUEUE | PROCESS | SUCCESS | FAIL
        "status": "SUCCESS",
        "result": {
            // 生成的视频URL
            "videoUrl": "https://example.com/generated-video.mp4"
        }
    }
}

4. 可用性检查

请求地址

[POST] https://api.tecmz.com/open_api/cloud_video_generate/available

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 当前可用服务器数量
        "availableCount": 1
    }
}

5. 示例代码

PHP

<?php
// 提交任务
$data = [
    'model' => 'wanx2.1-t2v-turbo',
    'prompt' => '一只可爱的小猫在花园里奔跑',
    'param' => [
        'resolution' => '720P',
        'ratio' => '16:9'
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://your-domain.com/open_api/cloud_video_generate/queue');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['code'] == 0) {
    $taskId = $result['data']['taskId'];

    // 查询结果
    while (true) {
        $queryData = ['taskId' => $taskId];
        curl_setopt($ch, CURLOPT_URL, 'https://your-domain.com/open_api/cloud_video_generate/query');
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($queryData));

        $queryResponse = curl_exec($ch);
        $queryResult = json_decode($queryResponse, true);

        if ($queryResult['data']['status'] == 'SUCCESS') {
            $videoUrl = $queryResult['data']['result']['videoUrl'];
            echo "生成成功，视频地址：$videoUrl\n";
            break;
        } elseif ($queryResult['data']['status'] == 'FAIL') {
            echo "生成失败\n";
            break;
        }

        sleep(5); // 等待5秒后重试
    }
}

curl_close($ch);