메인 콘텐츠로 건너뛰기

빠른 시작

비디오 생성은 비동기 작업이며, 전체 프로세스는 세 단계로 나뉩니다.
최소 예제

API 개요

Base URL: https://aihubmix.com 인증 방식: Bearer Token

지원 모델

텍스트-비디오 (Text-to-Video)

이미지-비디오 (Image-to-Video)

이미지-비디오는 input_reference 파라미터로 참조 이미지를 전달합니다(Alibaba Tongyi Wanxiang). Doubao Seedance는 extra_body.content 배열로 전달하며 이미지, 비디오, 오디오 등 다양한 참조 유형을 지원합니다. Kling은 image / image_tail / image_list로 이미지를 전달하며, 자세한 내용은 아래 Kling 섹션을 참조하세요.

API 상세 설명

요청 헤더

비디오 생성 작업 생성

요청 본문

모델별로 응답 형식이 약간 다르지만, 모두 id(video_id)와 status 필드를 포함합니다. status로 작업 진행 상황을 판단하면 됩니다.

응답 예시 (Tongyi Wanxiang/Veo/Jimeng)

응답 예시 (Sora)

공통 상태 값 설명

비디오 상태 조회

이 API를 폴링하여 작업 완료 여부를 확인합니다. 15초마다 한 번씩 조회하는 것을 권장합니다.

응답 예시 (생성 완료 - Tongyi Wanxiang)

응답 예시 (생성 완료 - Sora)

모든 모델은 status == "completed"로 완료 상태를 판단한 후, /content API를 호출하여 다운로드합니다.

비디오 콘텐츠 다운로드

상태가 completed가 되면 이 API를 호출하여 MP4 비디오 파일을 다운로드합니다. 응답: 비디오 바이너리 스트림을 직접 반환합니다(Content-Type: video/mp4).
주의: 비디오 다운로드 링크는 일반적으로 24시간의 유효 기간이 있으므로, 제때 다운로드하여 저장하세요.

비디오 작업 삭제

이 API는 이미 생성된 비디오 작업을 삭제하는 데 사용됩니다.

각 모델 파라미터 상세

OpenAI Sora

팁: 모든 모델의 seconds 파라미터는 통일적으로 문자열 타입으로 전달합니다(예: "8").
예제

Google Veo

예제
이미지 필드 참고:
  • 첫 프레임 우선순위: first_frame > input_reference(OpenAI 호환 단일 프레임).
  • first_frame / last_frame / reference_images의 각 요소는 다음을 허용합니다: 공개 URL, base64 데이터 URL(data:image/png;base64,...), 또는 {"mime_type":"image/png","data":"<base64>"} 객체.
  • OpenRouter 스타일의 frame_images(요소에 frame_type: first_frame | last_frame) 및 input_references 별칭도 허용됩니다.
  • 참조 이미지는 최대 3장까지 허용하며, 초과하면 400을 반환합니다.
팁: Veo는 네이티브 오디오 생성을 지원하므로, prompt에 효과음을 묘사할 수 있습니다. 예: “배경에 새소리가 들린다”, “피아노 선율”.

Tongyi Wanxiang

각 모델 지원 길이 지원 해상도 (너비*높이)
주의: wan2.6은 720P와 1080P만 지원; wan2.5는 480P, 720P, 1080P 지원; wan2.2는 480P와 1080P만 지원.
예제
팁: wan2.5 이상 버전은 기본적으로 음성이 있는 비디오를 생성하며(자동 더빙), 중국어 prompt의 효과가 더 좋습니다.

Jimeng

지원 가로세로 비율 및 대응 해상도 예제

Doubao Seedance

extra_body.content 지원 참조 유형 예제
Seedance 2.0 / 2.0 Fast

Kling

Kling은 텍스트-비디오, 이미지-비디오, 다중 이미지 참조 비디오, OmniVideo 멀티모달의 네 가지 기능을 지원하며, 통일적으로 /v1/videos API로 호출합니다. 게이트웨이가 「모델명 + 입력 형태」에 따라 Kling의 해당 엔드포인트로 자동 라우팅하므로 호출자가 구분할 필요가 없습니다. 파라미터
지원하지 않거나 매핑되지 않은 핵심 파라미터는 명시적으로 오류를 반환하며, 조용히 누락되지 않습니다. 그 외 Kling 네이티브 파라미터는 extra_body에 넣어 업스트림으로 전달할 수 있습니다.
예제
설명
  • 비동기 3단계: 제출하여 video_id 획득 → GET /v1/videos/{video_id}를 폴링하여 statuscompleted가 될 때까지 → GET /v1/videos/{video_id}/content로 MP4 다운로드. 상태 값: in_progress / completed / failed.
  • 비디오 생성은 일반적으로 1~3분 소요; 결과 비디오 URL은 30일 후 정리되므로 제때 전송 저장하세요.
  • 작업 삭제: Kling에는 삭제 API가 없으며, DELETE /v1/videos/{video_id}501 not_supported를 반환합니다.
  • 요금: 모델 × mode × 길이 × 기능(참조 비디오 유무 / 음성 유무)에 따라 과금; 생성 실패 시 과금되지 않으며, 조회와 다운로드는 과금되지 않습니다.

전체 호출 예제

FAQ

비디오 생성에는 얼마나 걸리나요?

비디오 생성은 일반적으로 1-5분이 소요되며, 구체적인 시간은 모델, 해상도, 길이에 따라 다릅니다. 15초의 폴링 간격을 설정하는 것을 권장합니다.

input_reference 파라미터는 어떻게 사용하나요?

input_reference는 이미지-비디오 시나리오에 사용되며, 세 가지 전달 방식을 지원합니다.

비디오 다운로드 링크의 유효 기간은 얼마나 되나요?

생성된 비디오 다운로드 링크는 일반적으로 24시간의 유효 기간이 있으므로, 제때 다운로드하여 저장하세요.

각 모델의 seconds 파라미터는 어떤 차이가 있나요?

> : 모든 모델의 seconds 파라미터는 통일적으로 문자열 타입으로 전달하며(예: "8"), API가 자동으로 처리합니다.

모델별 size 파라미터 형식은 어떤 차이가 있나요?

seconds duration 은 어떤 차이가 있나요?

둘은 의미가 동일하며 모두 비디오 길이를 나타냅니다. API는 이 두 파라미터명을 모두 지원합니다(Sora 제외, Sora는 seconds만 허용). 통일적으로 seconds 사용을 권장합니다.

더 나은 prompt를 작성하는 방법은?

  • 구체적인 장면 묘사: 주체, 동작, 환경, 조명, 분위기를 포함
  • 카메라 언어 지정: 예: “클로즈업”, “항공 촬영”, “푸시 인 샷”, “슬로우 모션”
  • 스타일 묘사: 예: “시네마틱”, “다큐멘터리 스타일”, “애니메이션 스타일”
  • 중국어 모델은 중국어 prompt 효과가 더 좋음: Tongyi Wanxiang은 중국어에 최적화됨
  • Veo는 오디오 묘사 지원: prompt에 소리를 묘사 가능, 예: “새소리”, “피아노 선율”

작업이 실패하면 어떻게 처리하나요?

statusfailed일 때, 응답의 error 필드에 오류 정보가 포함됩니다.

일반적인 실패 원인으로는 콘텐츠 위반, prompt 과다 길이, 이미지 형식 미지원 등이 있습니다. 오류 정보에 따라 조정한 후 재시도하세요.

마지막 업데이트: 2026-06-01