Veo
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | GV |
| ModelVersion | 3.1 / 3.1-fast / omni |
| 기본값 | ModelVersion=3.1 / Resolution=1080P |
| 가드레일 해제 지원 | 미지원 |
버전별 지원 규격
| 버전 | 해상도 | 비율 | 길이 |
|---|---|---|---|
| 공통 | 480P / 720P / 1080P / 2K / 4K | — | — |
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName | 필수 | String | 고정값 GV |
ModelVersion | 선택 | String | 3.1 / 3.1-fast / omni |
Prompt | 필수 | String | 생성 프롬프트 |
FileInfos.N | 선택 | Array | 참조 입력. Usage는 FirstFrame(첫 프레임) 또는 Reference(참조) |
OutputConfig.Resolution | 선택 | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | 선택 | Integer | 영상 길이(초) |
OutputConfig.AspectRatio | 선택 | String | 16:9 / 9:16 / 1:1 등 |
요청 예시
json
{
"SubAppId": 123456789,
"ModelName": "GV",
"ModelVersion": "3.1",
"Prompt": "a calm sunset over the ocean, cinematic",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}응답 예시
json
{
"AigcVideoTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1920,
"Height": 1080,
"Duration": 5.07,
"Container": "mov,mp4,m4a",
"Bitrate": 9494850
}
}
]
}
}
}Omni 입력 규격
Omni는 이미지 최대 10장, 영상 최대 3개 / 각 10초를 참조합니다. 비율은 16:9 / 9:16, 길이는 3–10초, 프레임률은 24fps입니다. 원본 해상도는 720P이며, 1080P / 2K / 4K는 업스케일 출력입니다.
특수 설정
omni 버전 사양
omni는 GV 계열 중 네이티브 오디오 생성과 상태 유지 편집을 지원하는 버전입니다.
| 항목 | 값 |
|---|---|
| 생성 모드 | 텍스트 투 영상, 이미지 참조, 영상 참조, 영상 편집, 상태 유지 편집 |
| 참조 이미지 | 최대 10장 |
| 참조 영상 | 최대 3개 / 각 10초 |
| 프롬프트 길이 | 최대 20,000자 |
| 오디오 | 모델이 영상과 함께 오디오를 생성합니다. |
| 화면 비율 | 16:9 / 9:16 |
| 해상도 | 720P / 1080P / 2K / 4K |
| 영상 길이 | 3~10초 |
| 프레임레이트 | 24 fps |
프롬프트 이미지 마커
omni는 프롬프트 안의 마커로 이미지의 역할을 지정합니다. 이미지 참조 번호는 0부터 시작합니다.
| 마커 | 역할 |
|---|---|
<FIRST_FRAME> | 이 이미지를 영상의 시작 프레임으로 사용 |
<IMAGE_REF_N> | N번째 이미지를 스타일이나 피사체 참조로 사용 |
text
<FIRST_FRAME> a woman is walking
in the style of <IMAGE_REF_0> a woman <IMAGE_REF_1> is walking두 번째 예시는 첫 번째 이미지를 스타일 참조로, 두 번째 이미지를 피사체 참조로 사용합니다.
상태 유지 편집 (PreviousTaskId)
PreviousTaskId로 이전 결과의 맥락을 이어받아 프롬프트로 반복 편집합니다. 지정한 변경 사항을 반영하고 나머지 요소는 유지합니다.
첫 번째 태스크를 만듭니다.
json
{
"SubAppId": 123456789,
"ModelName": "GV",
"ModelVersion": "omni",
"FileInfos": [
{
"Type": "Url",
"Url": "https://<cos>/f0.jpg"
}
],
"Prompt": "Two man are studying",
"EnhancePrompt": "Enabled",
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}반환된 TaskId를 ExtInfo의 PreviousTaskId로 넘겨 이어서 편집합니다.
json
{
"SubAppId": 123456789,
"ModelName": "GV",
"ModelVersion": "omni",
"Prompt": "Make the background invisible",
"EnhancePrompt": "Enabled",
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"PreviousTaskId\\\": \\\"<previous-task-id>\\\"}\"}",
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}상태 유지 편집은 24시간 이내 태스크만 가능합니다
PreviousTaskId는 생성 후 24시간 이내의 태스크를 지정합니다.
그 밖의 프롬프트 활용
| 목적 | 프롬프트 작성 요령 |
|---|---|
| 단일 장면 | 기본값은 멀티 샷입니다. 단일 장면을 원하면 프롬프트에 명시하세요 |
| 요소 제거 | 없애고 싶은 요소를 직접 지정합니다 |
| 오디오 지시 | 원하는 소리나 대사를 프롬프트에 함께 적습니다 |
| 시간 지정 이벤트 | 특정 시점의 동작을 순서대로 기술합니다 |
| 영상 속 텍스트 | 영상 안에 넣을 문자를 지정할 수 있습니다 |
| 메타 프롬프트 | 영상 품질이나 구성 원칙을 지시할 수 있습니다 |