MPS APILast Updated 2026-09-30

Vidu

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask

기본 정보

항목	값
ModelName	`Vidu`
ModelVersion	`q3-ad` / `q3-drama` / `q3-mix` / `q3-turbo` / `q3-pro` / `q3` / `q2-pro` / `q2` / `q2-turbo`
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	길이
`q3-ad`	`720P` / `1080P`	`16:9` / `1:1` / `9:16`	—
`q3-drama`	`1080P`	`16:9` / `9:16`	—
`q3-ad`	—	—	—
`q3-ad`	—	—	—
`q3-ad`	—	—	—
`q3-drama`	—	—	—
`q3-drama`	—	—	—

입력 조건

버전	조건
`q3-ad`	참조 이미지: `1–7장`
`q3-drama`	참조 이미지: `1–7장`
`q3-ad`	Resolution: `720P` AspectRatio: `16:9` 출력 픽셀: `1280×720`
`q3-ad`	Resolution: `1080P` AspectRatio: `1:1` 출력 픽셀: `1440×1440`
`q3-ad`	Resolution: `720P` AspectRatio: `9:16` 출력 픽셀: `720×1280`
`q3-drama`	Resolution: `1080P` AspectRatio: `16:9` 출력 픽셀: `1920×1080`
`q3-drama`	Resolution: `1080P` AspectRatio: `9:16` 출력 픽셀: `1080×1920`

이미지 참조와 등록한 참조 대상 기반 영상 생성을 지원합니다. q3 계열은 자동 컷 전환과 오디오 동시 생성을 지원합니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Vidu`
`ModelVersion`	선택	String	`q3-ad` / `q3-drama` / `q3-mix` / `q3-turbo` / `q3-pro` / `q3` / `q2-pro` / `q2` / `q2-turbo`
`Prompt`	필수	String	생성 프롬프트. 텍스트 입력 모드는 최대 `2000`자로 작성
`NegativePrompt`	선택	String	결과에서 제외할 요소. 지원 모델에서 적용
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 기본값 `false`
`ImageUrl`	선택	String	첫 프레임 이미지 URL. 외부 접근 가능해야 하고 `10MB` 이하
`LastImageUrl`	선택	String	끝 프레임 이미지 URL. `ImageUrl`과 함께 사용
`ImageInfos.N`	선택	Array	참조 이미지 배열. `ImageUrl` / `ReferenceType` 등
`Duration`	선택	Integer	생성 길이(초). 모델별 허용값만 반영
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio` / `EnableAudio`
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조
`SubjectInfos.N`	선택	Array	등록한 참조 대상 정보. `Id` / `Name` / `VoiceId` / `ImageUrls` / `VideoUrls`
`SceneType`	선택	String	`template_effect`(이펙트 템플릿)
`ExtraParameters.` `EnablelnputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
`ExtraParameters.` `EnableOutputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

text-to-video

LANGUAGE
{
  "ModelName": "Vidu",
  "ModelVersion": "q3-pro",
  "Prompt": "a paper boat drifting down a rainy street, warm lamplight",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

응답 예시

LANGUAGE
{
  "Response": {
    "Status": "DONE",
    "ErrCode": "",
    "Message": "ok",
    "Resolution": "1280x720",
    "VideoUrls": [
      "https://example.com/output/vidu.mp4"
    ],
    "RequestId": "7c43c2f7-ff98-45c4-9ac5-5742367c1a21"
  }
}

특수 설정

가드레일 해제

입력과 출력 심사를 각각 설정할 수 있습니다.

가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.

파라미터	해제 값	적용 대상
`ExtraParameters.EnablelnputComplianceCheck`	`false`	입력 심사 해제
`ExtraParameters.EnableOutputComplianceCheck`	`false`	출력 심사 해제

다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.

LANGUAGE
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

버전별 지원 능력

버전	특징
`q3-mix`	화면 완성도가 높고 자동 컷 전환, 오디오 동시 생성 지원. 참조 생성 전용
`q3-turbo`	자동 컷 전환, 오디오 동시 생성, 생성 속도 가장 빠름
`q3-pro`	오디오 포함 고품질 결과
`q3`	자동 컷 전환, 오디오 동시 생성, 멀티 앵글 장면 구성
`q2-pro`	참조 영상, 영상 편집, 영상 교체 지원
`q2` / `q2-turbo`	동적인 움직임과 디테일 표현

지원 모드

모드	설명	지원 버전
text-to-video	프롬프트만으로 생성. `5000`자 이하	`q3-turbo` / `q3-pro` / `q2`
image-to-video	이미지 `1장`을 첫 프레임으로 사용	`q3-turbo` / `q3-pro` / `q2-pro` / `q2-turbo`
첫 / 끝 프레임	이미지 `2장`을 첫 프레임과 끝 프레임으로 사용	`q3-turbo` / `q3-pro` / `q2-pro` / `q2-turbo`
참조 생성 (일반 이미지)	여러 이미지로 동일 대상 유지	`q3-ad` / `q3-drama` / `q3-mix` / `q3-turbo` / `q3` / `q2-pro` / `q2`
참조 생성 (참조 대상)	참조 대상 ID를 만들고 `@참조 대상id`로 참조	`q3-turbo` / `q3` / `q2-pro` / `q2` (영상 참조 대상는 `q2-pro`만)

참조 이미지 생성

ImageInfos[].ImageUrl에 참조 이미지를 지정합니다.

LANGUAGE
{
  "ModelName": "Vidu",
  "ModelVersion": "q3-ad",
  "Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
  "ImageInfos": [
    {
      "ImageUrl": "https://example.com/reference.jpg"
    }
  ],
  "Duration": 3,
  "ExtraParameters": {
    "Resolution": "720P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-seoul",
    "CosBucketPath": "/aigc/video/"
  },
  "Operator": "app"
}
{
  "ModelName": "Vidu",
  "ModelVersion": "q3-drama",
  "Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
  "ImageInfos": [
    {
      "ImageUrl": "https://example.com/reference.jpg"
    }
  ],
  "Duration": 12,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-seoul",
    "CosBucketPath": "/aigc/video/"
  },
  "Operator": "app"
}

추가 옵션

길이 범위

q3-ad는 3–16초입니다. q3-drama는 8–12초입니다. 참조 이미지는 ImageInfos[].ImageUrl로 최대 7장을 입력합니다. q2 계열은 1–10초입니다. Prompt는 2000자 이하로 작성합니다.