비디오 생성

플랫폼 또는 OpenAI Videos 경로로 HappyHorse 비디오 작업을 생성합니다.

텍스트 기반, 이미지 기반 및 참조 이미지 기반 비디오 생성을 지원합니다. 요청 본문에는 플랫폼 통합 필드 또는 input / parameters 구조를 사용할 수 있습니다.

POST/v1/video/generations

POST/v1/videos

플랫폼 통합 구조 또는 Alibaba 네이티브 input / parameters 구조로 HappyHorse 비동기 비디오 작업을 생성합니다. 두 구조는 같은 업스트림 요청으로 변환됩니다.

텍스트 기반 비디오 생성에는 이미지가 필요하지 않습니다. 이미지 기반 비디오 생성에는 시작 프레임 이미지 한 장이 필요합니다. 참조 기반 비디오 생성에는 참조 이미지 1~9장이 필요하며 프롬프트에서 [Image 1], [Image 2]로 이미지를 참조할 수 있습니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

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

TypeScript 타입 정의

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

model*string

HappyHorse 모델 ID입니다. happyhorse-1.0-t2v는 텍스트 기반 비디오 생성, happyhorse-1.0-i2v는 시작 프레임 이미지 한 장을 사용하는 비디오 생성, happyhorse-1.0-r2v는 참조 이미지 1~9장을 사용하는 비디오 생성에 사용됩니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

비디오 콘텐츠 프롬프트입니다. 참조 기반 비디오 생성에서는 [Image 1] 등의 표기로 참조 이미지를 지정할 수 있습니다.

길이1 <= length

images?array<>

이미지 기반 비디오 생성의 시작 프레임 이미지 URL입니다. 한 장만 전달합니다.

항목1 <= items <= 1

reference_images?array<>

참조 기반 비디오 생성에 사용하는 참조 이미지 URL입니다. 1~9장을 지원합니다.

항목1 <= items <= 9

duration?integer

비디오 길이이며 단위는 초입니다. 3~15를 지원하며 기본값은 5입니다.

범위3 <= value <= 15

기본값5

metadata?

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "두꺼운 종이와 병뚜껑으로 만든 미니어처 도시가 밤에 활기를 띱니다.",
    "duration": 5,
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "watermark": false,
      "seed": 12345
    }
  }'

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

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`