POST /flux/videos를 사용하여 동영상 생성, 키프레임 이미지-동영상 생성, 동영상 이어붙이기 및 초안 향상을 완료합니다. action=generate(기본값), mode로 생성 모드를 선택하며, 결과 조회는 모두 기존의 POST /flux/tasks를 사용합니다.
현재 Beta입니다. 텍스트-동영상, 이미지-동영상, 동영상 이어붙이기 및 초안 향상이 공개되었습니다. HTTP 200 및 작업 ID는 작업 수락만을 의미하며, 최종 결과를 계속 조회해야 합니다.
1. API Token 가져오기
- Ace Data Cloud 콘솔에서 등록 또는 로그인하고, 애플리케이션을 생성하여 API Token을 가져옵니다. 하나의 범용 API Token으로 플랫폼 서비스를 호출할 수 있습니다. 애플리케이션에 Flux 서비스 호출 권한과 사용 가능한 잔액이 있는지 확인하세요.
- Flux 서비스 페이지에서 요금제 및 각 작업의 가격을 확인합니다. 잔액이 부족한 경우 콘솔 잔액 페이지에서 충전하세요.
- 요청에는
Authorization: Bearer <당신의 Token>을 사용합니다. Token은 서버 측 환경 변수에 저장해야 하며, 프런트엔드 페이지, 공개 저장소, 스크린샷 또는 콜백 URL에 작성하지 마세요.
이 문서의 코드는 모두 환경 변수를 읽습니다:
전체 필드 및 온라인 디버깅은 Flux Videos API를, 작업 조회는 Flux Tasks API를 참조하세요.
2. 작업 및 입력 선택
생성 모델은
flux-3이고, action은 generate(기본값)입니다. mode를 통해 텍스트-동영상, 이미지-동영상, 동영상 이어붙이기 또는 초안 향상을 선택합니다.
공통 생성 파라미터
소재 URL은 서비스에서 읽을 수 있어야 합니다. 임시 서명 URL을 사용하는 경우, 다운로드 및 처리를 위해 충분한 유효 기간을 확보해야 합니다. 웹페이지 주소를 이미지 또는 동영상 파일 주소로 사용하지 마세요.
3. 텍스트-동영상: 전체 실측 요청 및 결과
다음 요청은 2026-10-02 가격 조정 전에 프로덕션 인터페이스에서 성공적으로 실행되었습니다.action을 생략하여 기본 생성 동작을 검증했으며, async=true는 HTTP 연결의 장시간 대기를 방지합니다.
task_id를 저장하고 계속 조회하세요. 문서 예시의 작업 ID를 사용하여 다른 계정의 결과를 조회하지 마세요.
response 필드에는 최종 비즈니스 결과가 포함됩니다. 다음은 이번 실측에서 성공한 response이며, 외부 작업 메타데이터는 생략되었습니다. 문서의 동영상 URL은 장기 예시 CDN의 동일 파일 복사본(SHA-256 일치)으로 교체되었으며, 실제 호출 시에는 이번 작업 고유의 결과 URL이 반환됩니다:
이는 가격 조정 전의 과거 실측입니다:
list_amount=2.9871876975 Credits, 계정은 당시 10% 소비 할인을 누렸으며, 실제 amount=2.68846892775 Credits였습니다. 2026-10-02 새 가격은 약 6.33% 인하되었습니다; 동일한 5.041667초 초안은 현재 가격 기준 2.798125185 Credits(소비 할인 전)이며, 여전히 10% 소비 할인을 누리는 경우 2.5183126665 Credits입니다. 과거 작업 청구서는 다시 계산되지 않습니다. 다른 계정의 요금제와 할인은 다를 수 있습니다; 이는 모든 사용자에게 고정된 미국 달러 가격이 아닙니다.
4. 이미지-비디오: 일반 및 시간 키프레임 포함
다음은 매개변수 예시이며, 소재 URL을 교체해야 하고, 이 예시가 이미 성공적으로 실행되었다는 선언이 아닙니다. 생성 완료 후 위의 절차에 따라 조회하면 결과 구조는 동일합니다. 한 장 또는 두 장의 이미지는 일반 배열을 사용합니다:[초 수, 이미지 URL] 쌍을 사용합니다:
이미지-비디오 실측 출력
이번 실측의 일치 입력은 다음과 같습니다(전체 base64는 설명 텍스트로만 대체되었으며, 나머지 필드는 실제 요청입니다):
이 PNG 키프레임 다운로드 후 Python의 base64.b64encode(image_bytes).decode("ascii")를 사용하여 원본 문자열을 얻고 keyframes 배열에 넣을 수 있습니다. 문서의 설명 텍스트를 이미지 입력으로 사용하지 마십시오.
다음은 2026-10-01 프로덕션 작업의 실제 최종 response입니다(시뮬레이션 응답이 아님); 비디오 URL만 해시가 동일한 장기 예시 사본으로 교체되었습니다. 실측 입력은 1280×720 PNG의 원본 base64 문자열을 단일 키프레임으로 사용했습니다; 위의 URL 입력은 독립적인 매개변수 예시입니다.
5. 영상 이어붙이기
start_video에 기존 영상 파일 주소를 전달하고, mode=v2v로 설정하며, 길이는 최대 15초입니다.
영상 이어붙이기 실측 출력
이번 전체 실측 입력은 다음과 같습니다. 초안 강화를 재현할 때는 자신의 초안 ID로 교체해야 합니다. 소재 URL은 동일 파일의 장기 예시 사본을 사용합니다.start_video는 완료된 초안 영상이며, 나머지 파라미터는 duration=5, resolution=hd, generate_audio=false입니다.
6. 먼저 초안, 그다음 강화
draft=true,resolution=hd로 초안을 생성하고 성공할 때까지 기다립니다.- 최종
data[0].draft_task_id에서 플랫폼 초안 ID를 가져옵니다. - 동일한 소속의 애플리케이션 자격 증명으로 강화 요청을 제출합니다.
prompt, duration, aspect_ratio, version, generate_audio, draft, keyframes, start_video를 전달할 수 없습니다. 초안 캐시는 임시 리소스이므로 신속히 강화하십시오. 영구 보존 또는 고정 보존 일수는 보장되지 않습니다. 본인/현재 애플리케이션의 초안이 아닌 경우, 미완료 초안 및 만료된 캐시는 재사용할 수 없습니다. 초안과 강화는 두 번의 작업이며, 성공 후 각각 과금됩니다.
초안 강화 실측 출력
이번 전체 실측 입력은 다음과 같습니다. 초안 강화를 재현할 때는 자신의 초안 ID로 교체해야 합니다. 소재 URL은 동일 파일의 장기 예시 사본을 사용합니다.7. Python 엔드투엔드 호출
requests를 설치하고, 자신의 Token을 설정한 뒤, 아래 스크립트를 실행하면 “한 번 제출 → 폴링 → 영상 URL 출력”을 완료할 수 있습니다. 조회 및 네트워크 재시도에는 모두 원래 task_id를 사용하여 유료 작업이 중복 제출되는 것을 방지해야 합니다.
8. 콜백 사용
제출 시callback_url을 추가하면, 작업 완료 후 해당 주소로 최종 JSON 결과를 POST합니다. 성공 구조는 앞서 언급한 response와 일치하며, 실패 시 error를 포함합니다.
9. 현재 과금 및 가격표
2026-10-02 업데이트: 이번 영상 인터페이스의 각 등급 단가가 약 6.33% 인하되었으며, 계량 방식, 요금제 및 소비 할인 규칙은 변경되지 않았습니다. 앞부분의 과거 실측 response에 있는 cost는 작업 완료 시점의 청구 금액이며, 현재 견적을 의미하지 않습니다. 영상 생성은 실제 출력 초 수를 기준으로 과금됩니다. 아래는 현재 계정 소비 할인이 적용되지 않은 Credits 단가이며, Flux 가격 페이지의 규칙과 일치합니다.
미국 달러 환산:
실제 비용(USD) = cost.amount(Credits) × 요금제 price / 요금제 amount। 충전 등급과 소비 할인은 실제 가격에 영향을 미치며, Credits를 직접 USD로 간주할 수 없습니다. 실패한 작업에는 생성 비용이 부과되지 않습니다. 최종 금액은 완료 결과와 콘솔 호출 기록을 기준으로 합니다.
10. 자주 묻는 질문 및 문제 해결
피드백 시 task_id, trace_id, 요청 시간 및 마스킹된 매개변수를 제공하고, API Token을 보내지 마세요. 더 많은 방법은 Flux MCP 통합 가이드를 참조하세요.

