비디오 편집

입력 비디오 하나가 필요하며 참조 이미지는 선택적으로 최대 다섯 장까지 제공할 수 있습니다. 요청 본문에는 플랫폼 통합 구조 또는 Alibaba 네이티브 미디어 구조를 사용할 수 있습니다.

POST/v1/videos/edits

입력 비디오 하나와 선택적 참조 이미지로 비동기 비디오 편집 작업을 생성합니다. 플랫폼 통합 구조는 input_reference와 reference_images를 사용하고 Alibaba 네이티브 구조는 input.media를 사용합니다.

비디오 편집은 입력 비디오 최대 하나와 참조 이미지 최대 다섯 장을 수신하며 ratio 매개변수는 지원하지 않습니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

플랫폼 통합 구조 또는 Alibaba 네이티브 구조를 선택하여 비디오 편집 요청을 제출합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

HappyHorse 비디오 편집 모델 ID입니다. 모델 기록에는 happyhorse-1.0-video-edit가 포함되며 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

원하는 비디오 편집 효과를 설명합니다.

길이1 <= length

input_reference*string

편집할 입력 비디오 URL입니다. 하나만 전달할 수 있습니다.

형식uri

reference_images?array<>

선택적 스타일 또는 콘텐츠 참조 이미지 URL입니다. 최대 다섯 장입니다.

항목items <= 5

metadata?

응답 본문

`application/json`

curl -X POST "https://example.com/v1/videos/edits" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "대상의 동작은 유지하면서 비디오 화면을 일몰 무렵의 따뜻한 황금빛 영화 스타일로 바꿔 주세요.",
    "input_reference": "https://example.com/input.mp4",
    "reference_images": [
      "https://example.com/style-reference.png"
    ],
    "metadata": {
      "resolution": "720p",
      "duration": 5,
      "watermark": false,
      "seed": 12345
    }
  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1640995200
}

인증

요청 본문

응답 본문

200application/json

`application/json`