MPS APILast Updated 2026-09-30

Jimeng

On this page

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

기본 정보

항목	값
ModelName	`Jimeng`
ModelVersion	`3.0pro`
기본값	`ModelVersion=3.0pro` / `Resolution=1080P`
가드레일 해제 지원	미지원

버전별 지원 규격

버전	해상도	비율	길이
공통	`480P` / `720P` / `1080P` / `2K` / `4K`	—	—

단일 버전 3.0pro를 제공하며, 해상도와 비율은 ExtraParameters에 지정합니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Jimeng`
`ModelVersion`	선택	String	`3.0pro`
`Prompt`	필수	String	생성 프롬프트. 최대 `2000`자
`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` 전달 형식은 추가 설정 참조

요청 예시

LANGUAGE
{
  "ModelName": "Jimeng",
  "ModelVersion": "3.0pro",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

응답 예시

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

특수 설정

추가 옵션

VOD 경로와의 차이

VOD 경로는 OutputConfig.Resolution / OutputConfig.Duration을 쓰지만, MPS 경로는 해상도와 비율을 ExtraParameters에, 길이를 최상위 Duration에 지정합니다.