영상 생성 API: 무료 AI 영상·이미지 API
두 줄의 요청을 사용하여 텍스트를 비디오로 변환합니다. 작업 제출 → 상태 폴링 → 비디오 검색. 무료, 그래픽 카드 없음, 개발자에게 친화적입니다.
Agnes 오픈 API(기본 URL은 https://apihub.agnes-ai.com)는 무료 비디오 및 이미지 모델을 위한 프로그래밍 인터페이스를 제공합니다. 일반적인 사용법은 다음과 같습니다. 먼저 작업을 작성한 다음 완료될 때까지 상태를 폴링한 다음 마지막으로 반환된 video_url에서 슬라이스로 다운로드합니다. 전체 과정 Bearer 인증, 제한 속도 분당 16회, 429에 부딪히면 자동으로 기하급수적으로 회피하여 다시 시도합니다.
API 엔드포인트
| Method | Endpoint | 설명 |
|---|---|---|
| POST | /v1/videos | 영상 생성 작업을 생성합니다. Body: model(agnes-video-v2.0), prompt, width/height, num_frames, frame_rate. 작업 id를 반환합니다. |
| GET | /agnesapi | video_id로 작업 상태를 폴링. status(pending/completed/failed), progress, 완료 시 video_url을 반환합니다. |
| POST | /v1/images/generations | agnes-image-2.1-flash 모델로 이미지 생성 작업을 만듭니다. prompt와 size 지정. |
| GET | /v1/models | 사용 가능한 텍스트·이미지·영상 모델과 model_id 목록을 반환합니다. |
API 기능
완전 무료, GPU 불필요
텍스트·이미지·영상을 하나의 키로 사용
비동기 작업을 약 30초 간격으로 폴링(최대 15분)
한국어 등 다국어 프롬프트 지원
해상도·프레임·길이 선택 가능(최대 720p)
분당 16회 제한과 자동 지수 백오프
빠른 시작 예제
# Step 1 — create a video job
import requests, time
API_KEY = "your-api-key" # get it free at platform.agnes-ai.com
BASE = "https://apihub.agnes-ai.com"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.post(f"{BASE}/v1/videos", headers=headers, json={
"model": "agnes-video-v2.0",
"prompt": "A white fox walking in a misty bamboo grove at dawn",
"width": 1152, "height": 768, # 16:9
"num_frames": 121, # ~5s @24fps
"frame_rate": 24,
})
resp.raise_for_status()
video_id = resp.json().get("video_id") or resp.json().get("task_id")
# Step 2 — poll the task until done
while True:
r = requests.get(f"{BASE}/agnesapi", headers=headers,
params={"video_id": video_id}).json()
if r["status"] == "completed":
print("Video URL:", r["video_url"]); break
if r["status"] == "failed":
raise RuntimeError(r.get("error", "generation failed"))
time.sleep(30)Agnes API를 쓰면 실제 영상 생성 기능을 무료로 앱에 넣을 수 있습니다. GET /v1/models로 model id를 확인하고, POST /v1/videos로 작업을 제출한 뒤 폴링하면 됩니다. 위의 제한 설정으로 빠르게 시작하세요.
관련 페이지
Agnes AI API 키 무료로 받기 — 3분 설정 | 무료 AI 영상 가이드
Agnes AI API 키를 완전 무료로 받는 방법: 계정 등록, 키 생성, 복사까지의 전체 단계와 웹 UI·환경 변수·API 등 3가지 설정 방법을 설명합니다. 401 오류 해결법과 자주 묻는 질문도 함께 제공됩니다.
Agnes Video Generator 셀프 호스팅 가이드 | 무료 AI 영상 가이드
무료 오픈소스 AI 비디오 생성 도구를 내 컴퓨터나 서버에서 실행: start.sh 수동 배포, Docker 원커맨드, npm CLI, AI 에이전트 보조 등 4가지 방법을 전체 명령어·시스템 요구사항·환경 변수와 함께 정리했습니다.
자주 묻는 질문 — AI 비디오 생성기 Q&A | Agnes Video
Agnes Video Generator에 대한 자주 묻는 질문 모음: Agnes AI 무료 비디오 모델을 사용하는 방법, 고성능 그래픽 카드가 실제로 필요하지 않은지, 어떤 비디오 모드와 최대 시간을 지원하는지, API 키를 무료로 받는 방법, 무료 한도 및 사용 제한, 유료 도구와의 차이점을 한꺼번에 설명합니다.
간단한 비디오 예시 프롬프트 — 텍스트→비디오 프롬프트 모음 | 무료 AI 비디오
간단한 이미지 비디오 모드에 대한 기성 프롬프트 단어 예: 호숫가의 황혼, 음식 클로즈업, 네온 야경 등 직접 복사 가능한 프롬프트 3개, 각각 매개변수 설정 및 화질 최적화 제안 사항이 포함되어 있습니다. 복사하여 붙여넣으면 안정적인 스타일의 짧은 비디오를 생성할 수 있으며, 초보자는 10분이면 시작할 수 있다.
API Contract & Conventions
Endpoints, auth, and parameters here follow the Agnes AI Open API, with reference to mainstream API conventions.
- Agnes AI Open API — 视频 / 图片生成接口Agnes AI · apihub.agnes-ai.com (2026)
The request/response contracts of all endpoints (/v1/videos, status polling, etc.) follow the Agnes Open API docs.
- OpenAI API Reference — REST 接口规范OpenAI · OpenAI Docs (2025)
Conventions like Bearer auth and REST-style design reference industry standards such as the OpenAI API Reference.
- Artificial Intelligence Index Report 2025Stanford HAI · Stanford AI Index 2025 (2025)
Stanford AI Index 2025 documents the explosive growth of the AI API economy, validating API documentation standardization as critical industry infrastructure.
- The Economic Potential of Generative AI: The Next Powerhouse of Productivity and Growth?McKinsey & Company · McKinsey Global Institute (2023)
McKinsey's report estimates the economic value of API-driven AI services in enterprise integration, providing developers a business case for API-based integration.
신뢰할 수 있는 이유
이 글은 주관적인 인상에 의한 결론이 아니라 arXiv 논문, 제조업체 기술 보고서 및 Stanford AI Index와 같은 1차 출처를 교차 확인하여 작성한 일선 실무자에 의해 작성되었다.
SandGrid@lcy362
Agnes Video Generator 개발자 · 풀스택 개발자
독립 개발자이자 오픈 소스 AI 비디오 생성 도구인 Agnes Video Generator의 저자입니다. 이 프로젝트는 Agnes AI의 완전 무료 비디오 모델을 기반으로 하며, MIT 프로토콜은 오픈 소스이며, 이미 1,000명 이상의 크리에이터가 무료 비용으로 AI 비디오를 제작할 수 있도록 도왔다. 비디오 생성 모델의 엔지니어링화와 보급에 오랫동안 관심을 기울여 왔으며, 글의 내용은 모두 일선 실천과 직접 연구에서 나왔다
GitHub에서 보기최종 업데이트:2026-08-21