MiniAPI 비디오, 이미지, 오디오
MiniAPI는 https://api.minicut.ai 에서 비디오, 이미지, 오디오 모델을 위한 하나의 선불 API 키입니다.
models에 coming soon으로 표시된 모델은 가격이 책정되어 있지만 아직 작업을 받지 않습니다. 다른 모델을 선택하세요.
가격은 초당 또는 이미지당이며 작업 실행 전에 설정됩니다. 실패한 작업은 요금이 부과되지 않습니다.
크레딧은 만료되지 않습니다.
헬퍼 스크립트(Node 18+, 설치 불필요): node scripts/miniapi.mjs <command>, 이 스킬의 폴더에서 실행하세요.
0단계. 키
MINIAPI_KEY가 설정되지 않은 경우, 사용자에게 한 줄로 알립니다: https://api.minicut.ai/console/keys?utm_source=skills-sh&utm_medium=skill&utm_campaign=miniapi-video 에서 키를 생성하고, 자금을 추가한 후($10 최소),export MINIAPI_KEY=mapi_live_...를 실행하세요. 사용자가 완료할 때까지 기다리세요.- 키를 절대 출력하지 마세요. 절대 프로젝트 파일에 기록하지 마세요.
1단계. 모델 선택
모든 ID와 시작 가격을 보려면 node scripts/miniapi.mjs models를 실행하세요.
해당 모델의 파라미터, 제한, 가격을 보려면 node scripts/miniapi.mjs model <id>를 실행하세요.
해당 모델 페이지에 나열된 파라미터만 사용하세요. 모델이 지원하지 않는 파라미터는 422 오류로 거부됩니다.
사용자가 특정 모델을 지정하지 않았을 때의 기본값:
| 작업 | 모델 ID | 이유 |
|---|---|---|
| 비디오, 최고 품질 | seedance-2.5 | 4~30초, 최대 1080p, 참조 기능, 기본적으로 사운드 포함 |
| 비디오, 저렴한 초안 | seedance-2.0-mini | $0.054/초부터 |
| 이미지 | models를 읽고 사용자가 지정한 이미지 모델을 선택, 없으면 가장 저렴한 이미지 모델 |
2단계. 견적 후 승인 요청
- 모델 페이지에서 JSON 본문을 구성합니다.
node scripts/miniapi.mjs quote <id> '<json>'를 실행합니다. 견적은 무료이며 실제로 실행되지 않습니다.- 사용자에게 PRICE 라인을 보여주고 승인을 요청합니다. 승인 없이 절대 제출하지 마세요.
- 한 번의 승인은 하나의 작업을 의미합니다. 재시도 또는 두 번째 클립은 새 견적과 새 승인이 필요합니다.
3단계. 실행
node scripts/miniapi.mjs run <id> '<json>' --yes --out <folder>
다시 견적을 내고, 제출하고, 대기한 후 파일을 <folder>에 다운로드하고 SAVED <path>와 CHARGED <price>를 출력합니다.
사용자에게 저장된 경로를 보여줍니다. 사진인 경우 열어줍니다. 클립인 경우 경로를 알려줍니다.
오류
| 종료 코드 | 의미 | 수행할 작업 |
|---|---|---|
| 3 | 키 없음 | 0단계 |
| 4 | 잔액 부족 | 사용자에게 가격과 출력된 자금 추가 링크를 알림 |
| 5 | MiniAPI가 본문을 거부함 | 메시지를 읽고 모델 페이지의 필드를 수정한 후 다시 견적 |
| 7 | 작업 실패 | 요금이 부과되지 않음. 그 사실을 알리고 새 견적으로 변경된 재시도를 제안 |
예시
사용자: "새벽에 눈밭을 달리는 붉은 여우의 5초 클립을 만들어 줘, 720p"
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}'
# PRICE 1.750000 USD ... 견적은 무료입니다. 실제로 실행되지 않았습니다.
# (사용자에게 묻고 승인을 기다림)
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}' --yes --out clips
문서: https://api.minicut.ai/docs . 모든 모델의 Markdown: https://api.minicut.ai/llms.txt