Veo
On this page
Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | GV |
| ModelVersion | 3.1 / 3.1-fast / 3.1-lite / omni |
| 가드레일 해제 지원 | 미지원 |
영상 참조 생성과 상태 유지 영상 편집을 지원하고, 오디오를 네이티브로 함께 생성합니다.
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 GV |
ModelVersion |
선택 | String | 3.1 / 3.1-fast / 3.1-lite / omni |
Prompt |
필수 | String | 생성 프롬프트. 아래 버전별 제한 참조 |
NegativePrompt |
선택 | String | 결과에서 제외할 요소. 지원 모델에서 적용 |
EnhancePrompt |
선택 | Boolean | 프롬프트 자동 보정. 기본값 false |
ImageUrl |
선택 | String | 첫 프레임 이미지 URL. 외부 접근 가능해야 하고 10MB 이하 |
LastImageUrl |
선택 | String | 끝 프레임 이미지 URL. ImageUrl과 함께 사용 |
ImageInfos.N |
선택 | Array | 참조 이미지 배열. Category / Url / ReferenceType 등 |
Duration |
선택 | Integer | 생성 길이(초). 모델별 허용값만 반영 |
ExtraParameters |
선택 | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters |
선택 | String | 모델 전용 옵션을 담은 JSON 문자열. seed 전달 형식은 추가 설정 참조 |
요청 예시
text-to-video
LANGUAGE
{
"ModelName": "GV",
"ModelVersion": "3.1",
"Prompt": "a timelapse of a blooming flower, soft sunlight",
"Duration": 8,
"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",
"Message": "ok",
"Resolution": "1920x1080",
"VideoUrls": [
"https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}특수 설정
모델 사양
| 항목 | 값 |
|---|---|
| 생성 모드 | text-to-video, 이미지 참조 생성, 영상 참조 생성, 상태 유지 영상 편집 |
| 참조 제약 | 영상 없이 이미지 최대 7장, 영상과 함께 사용하면 이미지 최대 5장, 총 쿼터 7. 참조 영상은 3초 이하 |
| 프롬프트 상한 | 20000자 |
| 오디오 | 네이티브 동시 생성. 외부 오디오 업로드는 — |
| 화면 비율 | 16:9 / 9:16 |
| 해상도 | 720P / 1080P(업스케일 출력), 2K(업스케일 출력), 4K(업스케일 출력) |
| 길이와 프레임레이트 | 3~10초, 24fps |
상태 유지 영상 편집
이전 생성 태스크의 결과를 이어서 편집합니다. AdditionalParameters에 PreviousTaskId를 넣으면 되고, 하루 이내에 생성된 태스크만 지정할 수 있습니다.
LANGUAGE
{
"ModelName": "GV",
"ModelVersion": "3.1",
"Prompt": "extend the shot, camera pans to the right",
"Duration": 8,
"AdditionalParameters": "{\"PreviousTaskId\":\"<previous-task-id>\"}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}