빠른 시작
비디오 생성은 비동기 작업이며, 전체 프로세스는 세 단계로 나뉩니다.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)
공통 상태 값 설명
비디오 상태 조회
응답 예시 (생성 완료 - Tongyi Wanxiang)
응답 예시 (생성 완료 - Sora)
모든 모델은status == "completed"로 완료 상태를 판단한 후,/contentAPI를 호출하여 다운로드합니다.
비디오 콘텐츠 다운로드
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}를 폴링하여status가completed가 될 때까지 →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에 소리를 묘사 가능, 예: “새소리”, “피아노 선율”
작업이 실패하면 어떻게 처리하나요?
status가 failed일 때, 응답의 error 필드에 오류 정보가 포함됩니다.