Veo

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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

{
  "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
}

응답 예시

{
  "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를 넣으면 되고, 하루 이내에 생성된 태스크만 지정할 수 있습니다.

{
  "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
}