哪都通图生视频 (Antigravity)
이 Skill의 독립적인 Python 클라이언트를 사용하여 후보 비디오를 생성합니다. 기본 모델은 실제 테스트된 seedance-2.5이며, 제작 과정은 특정 프로젝트 엔지니어링, 다른 작업 트리 또는 배포 상태에 의존하지 않습니다.
로컬 구성 및 실행 진입점
- 통일된 인증 정보는
NXTPATH_API_KEY이며, 기본적으로 환경 변수 또는~/.config/nxtpath/env에서 읽습니다. 환경 변수가 우선하며,NXTPATH_ENV_FILE을 통해 다른 프라이빗 설정 파일을 지정할 수 있습니다. 다른 애플리케이션의 채팅 토큰을 읽지 말고, 키를 명령줄, Skill, 보고서 또는 작업 기록에 넣지 마십시오. - 새 zsh 프로세스는
~/.zshenv를 통해 로컬 설정을 로드합니다. GUI 또는 이전 프로세스가 환경을 상속하지 않은 경우에도 클라이언트는 위 파일을 직접 읽을 수 있습니다. 구성이 존재하는지만 보고하고 내용을 표시하지 마십시오. - 현재 로드된 Skill 디렉터리에서
scripts/nxtpath_video.py를 찾습니다.~/.config/nxtpath/venv/bin/python을 우선 사용하며, 해당 경로가 없으면 HTTPS 참조 이미지 및 비디오 API는 Python 3.9+로 직접 실행할 수 있습니다. 로컬 이미지 호스팅에는scripts/requirements.txt의 boto3가 추가로 필요합니다. - 대상 프로젝트에서 먼저 적용 가능한 리소스 및 개인정보 보호 규칙을 읽습니다. 작업은 기본적으로 해당 프로젝트에서 무시되는
tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/에 배치됩니다. 프로젝트가 없으면 사용자가 선택한 출력 디렉터리를 사용합니다. 이전 attempt를 덮어쓰지 말고, 후보를 자동으로 빌드 또는 공식 리소스에 추가하지 마십시오.
한 번의 제작 또는 기존 작업 복구
사용자가 특정 비디오 생성을 명확히 요청한 경우, 해당 요청에 따라 한 번의 생성을 완료하고 일반적인 확인을 반복하지 않습니다. 경로, 구성 또는 Skill 사용법에 대한 질문은 유료 생성을 승인하지 않습니다. 배치 수, 재작업 횟수 및 비용 범위는 이번 사용자 협의를 따릅니다. 협의되지 않은 경우 먼저 하나를 생성하고, 자동으로 확장하거나 실패한 작업을 재생성하지 않습니다.
run_command를 통해doctor --check-api를 실행하여 인증 정보와 사용 가능한 모델을 확인합니다. 이는 읽기 전용 요청이며 비디오를 생성하지 않습니다.- 참조 이미지와 동작 설명을 확인합니다 (로컬 참조 이미지는 먼저
read_file을 사용하여 확인). 동작 단계, 쇼트, 구도, 길이, 유지해야 할 캐릭터 및 소품을 명확히 합니다. 지정되지 않은 샘플은 기본 4초 / 480p이며, 기본 저해상도 샘플을 공식 완성본으로 간주하지 마십시오. 기본 프레임 속도, 캐릭터 일관성, 시작 및 끝 자세, 투명도는 실제 비디오를 기준으로 합니다. - 프롬프트를 UTF-8 파일로 저장하고
prepare를 사용하여 불변 입력을 설정합니다.--reference는 로컬 PNG/JPEG/WebP 또는 HTTPS 이미지 URL을 반복해서 전달할 수 있습니다. 이는 일반적인 가이드 이미지이며, API가 처음과 끝 키프레임을 고정했다고 주장할 수 없습니다. 텍스트로 비디오를 생성하는 경우 참조 이미지를 전달하지 않아도 됩니다. - 로컬 이미지가 있는 경우
host를 실행하여 입력 스냅샷을 구성된 프라이빗 R2 버킷에 업로드 또는 재사용하고, 24시간 GET 서명을 발급하며 다운로드 해시를 확인합니다. 이 작업은 참조 이미지를 호스팅 서비스 및 비디오 제공업체에 전달합니다. 사용자가 요청한 자료 범위 내에서 이루어져야 합니다. 호스팅에 실패하면 비디오를 제출하지 말고, 자동으로 계정, 공용 버킷 또는 서비스를 변경하지 마십시오. 이미 HTTPS 참조 이미지가 있는 경우host가 필요하지 않습니다. submit을 한 번만 실행합니다. 먼저 배타적 제출 기록을 유지한 후 유료 POST를 보냅니다. 그 후 독립적인status로 조회하고, 성공 시download로video.mp4를 가져옵니다. 각 명령은run_command를 통해 개별적으로 실행되며, 분 단위 폴링을 단일 긴 셸 호출에 포함시키지 말고, 타이머로 셸sleep을 절대 사용하지 마십시오. 대기가 필요한 경우schedule(DurationSeconds=...)를 사용하여 단일 타이머를 설정하고 현재 라운드를 종료한 후 깨어나서 다시status를 실행합니다. 시간 초과로 인해 생성 요청을 다시 보내지 마십시오.- 대화를 넘어 복구할 때는 원래 job 경로를 사용하여 먼저
inspect를 실행한 후status/download를 실행합니다. 이미 제출되었거나 결과가 불분명하거나 작업 ID가 없는 attempt는 POST를 반복해서는 안 됩니다. 작업 ID가 없으면 프라이빗 제출 기록을 기반으로 제공업체에 확인합니다. 다운로드 실패 시 다운로드만 재시도합니다. 401/403, 크레딧 부족 또는 모델을 사용할 수 없는 경우 제출을 중단하고 이유를 보고하며, 자동으로 키, 모델 또는 인터페이스를 변경하지 마십시오.
명령 예시 (CLIENT는 실제 Skill의 스크립트, PY는 로컬 Python, JOB은 이번에 새로 생성된 작업 디렉터리):
"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --reference "$REFERENCE_IMAGE" --duration 4 --resolution 480p --ratio 1:1
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"
결과물 제공 및 경계
재생 가능한 로컬 비디오와 job 경로로 결과물을 제공하고, [video.mp4](file:///absolute/path/to/video.mp4) 링크를 사용하여 비디오를 표시하며, 후보임과 실제 확인한 내용을 설명합니다. 완성본을 검토해야 하는 경우, Antigravity의 read_file 도구를 사용하여 다운로드된 video.mp4를 직접 읽고 (기본적으로 비디오 멀티모달 읽기를 지원), 원래 속도, 주요 동작 및 시작/끝 자세를 확인합니다. HTTP 성공을 동작 또는 아트 통과로 간주하지 마십시오.
작업 기록에는 프롬프트, 입력 스냅샷, 정확한 요청, 제공업체 작업 핸들, 결과 및 파일 해시가 포함되며, 권한은 기본적으로 현재 사용자만 읽을 수 있습니다. 이러한 기록에는 임시 서명 URL이 포함될 수 있으며, 전체 내용을 채팅에 붙여넣거나 Git에 커밋해서는 안 됩니다. 콘솔에는 작업 핸들의 지문만 표시합니다. 투명 배경 제거, SVG 연결 및 앱 연동은 후속 제작에 해당하며, 대상 프로젝트의 도구와 권한에 따라 처리합니다.
장치 변경, 인증 정보 업데이트 또는 호스팅 실패 시에만 설정 및 장애 복구를 읽습니다. 인터페이스 정보는 제공업체 Seedance Skill을 참조하십시오.