VisionCraft
Agnes AI API를 통해 이미지와 비디오를 생성합니다. scripts/ 디렉토리의 PowerShell 스크립트를 호출합니다. API 키는 환경 변수 AGNES_API_KEY에서 읽어옵니다.
처음 사용하시나요? 사전 준비 사항을 참조하세요. 프롬프트 작성 팁과 매개변수 세부 정보는
references/를 확인하세요.
빠른 참조
| 작업 | 명령어 |
|---|---|
| 텍스트-이미지 | scripts/gen_image.ps1 -Prompt "..." |
| 이미지-이미지 | scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..." |
| 텍스트-비디오 | scripts/gen_video.ps1 -Prompt "..." |
| 이미지-비디오 | scripts/gen_video.ps1 -Prompt "..." -Image "https://..." |
| 다중 이미지 비디오 | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" |
| 키프레임 애니메이션 | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes |
기본값: 이미지 2048x2048. 비디오 1920x1080 @ 60fps, 241프레임 (~4초).
사전 준비 사항
API 키를 한 번 설정하면 세션 간 유지됩니다:
[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-your-key-here", "User")
또는 현재 세션에만 설정:
$env:AGNES_API_KEY = "sk-your-key-here"
echo $env:AGNES_API_KEY로 확인합니다.
이 스킬 사용 방법
1. 요청 식별
| 사용자 말 | 모드 |
|---|---|
| "~의 그림을 만들어/그려/생성해줘" | 텍스트-이미지 |
| "이 이미지를 편집/변환/스타일 변경해줘..." (URL 제공) | 이미지-이미지 |
| "~의 비디오/애니메이션/클립을 만들어줘" | 텍스트-비디오 |
| "이 사진을 애니메이션화/움직이게 해줘" (1개 이미지) | 이미지-비디오 |
| "이 이미지들을 하나의 비디오로 합쳐줘" (여러 이미지) | 다중 이미지 비디오 |
| "A에서 B로 부드럽게 전환/모핑해줘" (2개 이상 이미지) | 키프레임 애니메이션 |
2. 필요시 프롬프트 다듬기
요청이 모호하면 실행 전에 간단히 더 풍부한 프롬프트를 제안합니다. 프롬프트 구조와 모범 사례는 references/prompt-guide.md를 참조하세요.
3. 스크립트 실행
가장 간단한 제어를 위해 -Ratio로 종횡비를, -Seconds로 지속 시간을 전달합니다. 모든 매개변수는 references/parameters.md를 참조하세요.
# 예시:
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8
4. 결과 표시
스크립트는 성공 시 MEDIA:<url> 줄을 출력합니다. 항상 URL을 별도 줄로 표시하고 절대 문단 안에 숨기지 마세요. 플랫폼이 인라인 미디어 렌더링을 지원하면 이를 포함하고, 그렇지 않으면 URL만으로 충분합니다.
사용자가 명시적으로 요청하지 않는 한 결과를 로컬 디스크에 다운로드하지 마세요.
출력 형식
이미지:
✅ 이미지 생성됨.
MEDIA:https://platform-outputs.agnes-ai.space/images/...
비디오:
🎬 비디오 생성됨 (4.0초, 1920x1080).
MEDIA:https://platform-outputs.agnes-ai.space/videos/...
오류 및 문제 해결
| 오류 | 해결 방법 |
|---|---|
AGNES_API_KEY not set | API 키를 설정하세요 (사전 준비 사항 참조). 필요시 터미널을 다시 시작하세요. |
| 401 Unauthorized | API 키가 유효하지 않거나 만료됨. |
| 400 Bad Request | 프롬프트, 크기 형식, 프레임 수 규칙(8n+1, ≤441)을 확인하세요. |
| 503 Service Unavailable | 서비스가 사용 중임. 30초 기다린 후 재시도하세요. |
| 비디오 타임아웃 (15분) | 스크립트가 video_id를 출력함 — 나중에 다시 조회하세요. 작업이 포기되지 않았습니다. |
전체 API 동작은 references/api_docs.md를 참조하세요.
참고 파일
references/api_docs.md— 전체 Agnes API 명세references/prompt-guide.md— 이미지 및 비디오 프롬프트 구조references/parameters.md— 모든 스크립트 매개변수와 예제