Communitygithub.com

Newdvn2025/topic-to-published-video

AutoDL Art API를 통해 B-roll 비디오를 생성, 이어붙이기 및 다운로드합니다. 텍스트, 참조 이미지, 첫 번째 및 마지막 프레임 입력을 지원합니다.

topic-to-published-video란 무엇인가요?

이 스킬은 AutoDL Art API를 활용하여 사용자가 승인한 비디오 소재 생성 작업을 자동화합니다. 먼저 실제 구술 콘텐츠, 소재 부족 현황 및 사용자 예산을 확인한 후, 매니페스트(manifest)를 생성합니다. 사용자는 계획만 수립하고 아직 제출하지 않아야 합니다. 기본 텍스트 생성 워크플로우는 minimax_h3_lightx2v_no_pic을 사용하며, 4~5초 길이의 768p 가로 영상을 생성합니다. 동작 데모의 경우 사용자 요청에 따라 길이를 연장할 수 있습니다. 생성된 영상의 화면비가 정확히 16:9가 아닐 수 있으므로, 다운로드 후 실제 측정을 통해 프로젝트 요구사항에 맞게 파생 버전을 만들고 원본은 보존합니다. 이 스킬은 Cursor, Claude Code 및 기타 AI 에이전트 개발 환경과 호환되며, Python 3.10+에서 실행됩니다. 환경 변수 AUTODL_ART_TOKEN 또는 사용자 설정 디렉터리의 autodl.env 파일을 통해 API 키를 안전하게 관리하며, 채팅, 명령 인수, 매니페스트 또는 상태 파일에 키를 절대 포함하지 않습니다. 작업 ID는 즉시 저장되며, 동일한 출력 디렉터리에서 반복 실행 시 이미 기록된 작업을 이어서 진행하므로 추가 비용이 발생하지 않습니다. 실패한 작업은 자동 재시도되지 않으며, 추가 생성은 새 ID와 새 출력 디렉터리를 사용하고 예산 승인을 다시 받아야 합니다. 또한, 이미 제출된 동일 ID의 요청 내용을 변경해서는 안 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Newdvn2025/topic-to-published-video/tree/HEAD/addons/autodl-broll

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

AutoDL B-roll

먼저 실제 구술 콘텐츠, 소재 부족 현황 및 사용자 예산을 확인하여 매니페스트(manifest)를 생성합니다. 사용자는 계획만 수립하고 아직 제출하지 않아야 합니다. 기본 텍스트 생성 워크플로우는 minimax_h3_lightx2v_no_pic이며, 4~5초 길이의 768p 가로 영상을 생성합니다. 동작 데모의 경우 사용자 요청에 따라 길이를 연장할 수 있습니다. 생성된 영상의 화면비가 정확히 16:9가 아닐 수 있으므로, 다운로드 후 실제 측정을 통해 프로젝트 요구사항에 맞게 파생 버전을 만들고 원본은 보존합니다.

설정 및 실행

Python 3.10+가 필요하며, 별도의 타사 Python 의존성은 없습니다. 환경 변수 AUTODL_ART_TOKEN을 최우선으로 읽으며, 그 다음으로 사용자 설정 디렉터리의 topic-to-published-video/autodl.env 파일을 읽습니다. --env-file 옵션을 사용하여 다른 파일을 지정할 수도 있습니다. 환경 변수가 우선합니다. API 키를 채팅, 명령 인수, 매니페스트 또는 상태 파일에 절대 포함하지 마십시오.

참조 이미지의 상대 경로는 매니페스트 디렉터리를 기준으로 해석되며, 로컬 이미지는 data URL로 변환됩니다.

python3 scripts/autodl_broll.py manifest.json --prepare-only --output-dir output

이 명령은 요청 본문의 유효성만 검사하고 디스크에 저장하며, API를 호출하지 않습니다. 사용자 승인 후:

python3 scripts/autodl_broll.py manifest.json --output-dir output

작업 ID는 즉시 저장됩니다. 동일한 출력 디렉터리에서 반복 실행 시 이미 기록된 작업을 이어서 진행하며, 추가 비용으로 재제출하지 않습니다. 실패한 작업은 자동 재시도되지 않습니다. 추가 생성은 새 ID와 새 출력 디렉터리를 사용하며, 해당 예산 승인을 다시 받아야 합니다. 이미 제출된 동일 ID의 요청 내용을 변경하지 마십시오.

워크플로우 및 승인 기준

텍스트: minimax_h3_lightx2v_no_pic. 참조 이미지: minimax_h3_z0902, 최소 ref_image_0 필요. 첫 번째 및 마지막 프레임: minimax_h3_b99_002, first_frame과 last_frame은 필수 입력 항목입니다. 더 많은 워크플로우와 정확한 열거는 API 설명을 참조하십시오. 서로 다른 워크플로우 간에 resolution 값을 혼용할 수 없습니다.

API 사용 가능 여부와 가격은 현재 계정 및 서비스에 따라 결정됩니다. 고정 단가 또는 다른 서비스보다 항상 저렴함을 보장하지 않습니다. 요청이 SUCCESS를 반환한 후에도 비어 있지 않은 파일, 매개변수 및 완전한 동작을 확인해야 합니다. 워크플로우 디렉터리가 의미론적 승인을 담당합니다.

프롬프트를 구성해야 하는 경우 프롬프트 가이드를 읽으십시오. 시작 시 텍스트 예제 또는 첫 번째/마지막 프레임 예제를 복사할 수 있습니다.

관련 스킬