영상 생성 API

사용 가능

모든 주요 비디오 모델을 하나의 엔드포인트로. 필드 하나만 바꿔 모델을 전환하세요.

17개 모델 중 480p에서 $0.0078/초부터최저가Wan 2.2 Fast

$0.0078/초부터 · 공식가보다 48% 저렴

입력

프롬프트prompt클립에서 일어나는 일.

79 / 4,000

품질quality

길이duration

화면 비율aspect_ratio

공식가 $0.075보다 48% 저렴 · 480p × 5초공식가 대비 -48%

예시

출력 예시이 프롬프트로 만듦

영상 생성 API 모델 비교

이 엔드포인트의 모든 모델을 실시간 가격과 함께 보여 줍니다. 플레이그라운드에서 써 보거나 모델 페이지를 여세요.

Wan 2.2 FastAlibaba480p에서 $0.0078/초
$0.015/초-48%최저가480p · 720p
페이지
Hailuo 02MiniMax480p에서 $0.013/초
$0.01667/초-22%480p · 720p · 1080p
페이지
Grok Imagine VideoxAI480p에서 $0.0156/초
$0.05/초-68%최고 가성비480p · 720p
페이지
Seedance 2.0 MiniByteDance480p에서 $0.0247/초
$0.0352/초-29%480p · 720p
페이지
Kling 2.1Kling720p에서 $0.0325/초
720p · 1080p
페이지
Hailuo 2.3MiniMax720p에서 $0.03792/초
$0.04667/초-18%720p · 1080p
페이지
Wan 2.5Alibaba480p에서 $0.039/초
$0.05/초-22%480p · 720p · 1080p
페이지
Kling 2.5 Turbo ProKling1080p에서 $0.0546/초
$0.07/초-22%1080p
페이지
Kling O3Kling720p에서 $0.065/초
$0.084/초-22%720p · 1080p
페이지
Seedance 1.5 ProByteDance1080p에서 $0.065/초
$0.116/초-43%1080p
페이지
Veo 3.1 FastGoogle720p에서 $0.065/초
$0.08/초-18%720p · 1080p · 4K
페이지
Wan 2.6Alibaba720p에서 $0.091/초
제작사 가격보다 낮음720p · 1080p
페이지
Wan 3.0Alibaba720p에서 $0.0975/초
제작사 가격보다 낮음720p
페이지
HappyHorse 1.0Alibaba720p에서 $0.104/초
$0.14/초-25%최고720p · 1080p
페이지
Kling 3.0 TurboKling720p에서 $0.1105/초
제작사 가격보다 낮음720p
페이지
Veo 3.1Google720p에서 $0.156/초
$0.20/초-22%720p · 1080p · 4K
페이지
Seedance 2.5ByteDance480p에서 $0.2867/초
제작사 가격보다 낮음480p · 720p · 1080p
페이지

이 도구의 모든 모델과 가격
		공식			길이 / 크기	배지	작업
Wan 2.2 FastAlibaba	480p에서 $0.0078/초	$0.015/초	-48%	480p · 720p	5초	최저가	페이지
Hailuo 02MiniMax	480p에서 $0.013/초	$0.01667/초	-22%	480p · 720p · 1080p	6–10초		페이지
Grok Imagine VideoxAI	480p에서 $0.0156/초	$0.05/초	-68%	480p · 720p	6–10초	최고 가성비	페이지
Seedance 2.0 MiniByteDance	480p에서 $0.0247/초	$0.0352/초	-29%	480p · 720p	5–10초		페이지
Kling 2.1Kling	720p에서 $0.0325/초	공식 가격 없음	—	720p · 1080p	5–10초		페이지
Hailuo 2.3MiniMax	720p에서 $0.03792/초	$0.04667/초	-18%	720p · 1080p	6–10초		페이지
Wan 2.5Alibaba	480p에서 $0.039/초	$0.05/초	-22%	480p · 720p · 1080p	5–10초		페이지
Kling 2.5 Turbo ProKling	1080p에서 $0.0546/초	$0.07/초	-22%	1080p	5–10초		페이지
Kling O3Kling	720p에서 $0.065/초	$0.084/초	-22%	720p · 1080p	5–10초		페이지
Seedance 1.5 ProByteDance	1080p에서 $0.065/초	$0.116/초	-43%	1080p	4–12초		페이지
Veo 3.1 FastGoogle	720p에서 $0.065/초	$0.08/초	-18%	720p · 1080p · 4K	4–8초		페이지
Wan 2.6Alibaba	720p에서 $0.091/초	제작사 가격보다 낮음	—	720p · 1080p	5–10초		페이지
Wan 3.0Alibaba	720p에서 $0.0975/초	제작사 가격보다 낮음	—	720p	5–30초		페이지
HappyHorse 1.0Alibaba	720p에서 $0.104/초	$0.14/초	-25%	720p · 1080p	5–10초	최고	페이지
Kling 3.0 TurboKling	720p에서 $0.1105/초	제작사 가격보다 낮음	—	720p	5–10초		페이지
Veo 3.1Google	720p에서 $0.156/초	$0.20/초	-22%	720p · 1080p · 4K	4–8초		페이지
Seedance 2.5ByteDance	480p에서 $0.2867/초	제작사 가격보다 낮음	—	480p · 720p · 1080p	4–15초		페이지

코드에서 영상 생성 API 호출하기

위의 모든 모델을 엔드포인트 하나로. model 필드만 바꾸면 전환됩니다.

POSThttps://api.opennan.com/v1/videos/generations

GET/v1/models?category=video이 엔드포인트의 모든 모델과 가격

API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기

첫 요청 보내기

플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.

curl https://api.opennan.com/v1/videos/generations \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan-2-2-fast","prompt":"밤의 네온 거리에 내리는 비, 느린 푸시인","duration":5,"quality":"480p","aspect_ratio":"16:9"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

작업 확인하기
호출하면 바로 작업 ID가 돌아옵니다. 끝날 때까지 작업을 확인하세요:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
워커 대기 중
running
생성 중
succeeded
완료: outputs[].url에 파일이 있습니다
failed
실패: 요금이 청구되지 않습니다

파라미터

실시간 카탈로그로 만든 표입니다. 여기 있는 값은 모두 API가 받습니다.

파라미터
이름	형식	허용 값	기본값	가격 영향
`model`필수호출을 실행할 모델.	문자열	—	—	—
`prompt`선택영상에서 일어나는 일. 시작 이미지를 보내지 않으면 필수입니다.	문자열	—	—	—
`image`선택시작 이미지(https 링크). 영상이 여기서 시작합니다.	URL	—	—	—
`end_image`선택끝 이미지(https 링크). 영상이 여기서 끝납니다.	URL	—	—	—
`reference_images`선택영상에 유지할 인물이나 사물 이미지(https 링크).	목록	—	—	—
`duration`선택영상 길이(초).	정수	4 · 5 · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 · 16 · 17 · 18 · 19 · 20 · 21 · 22 · 23 · 24 · 25 · 26 · 27 · 28 · 29 · 30	—	길수록 비쌈
`quality`선택출력 해상도.	문자열	480p · 720p · 1080p · 4K	—	높을수록 비쌈
`aspect_ratio`선택화면 비율. 예: 16:9, 9:16.	문자열	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21	—	—
`generate_audio`선택영상에 맞춘 소리를 넣습니다.	불리언	—	—	소리를 넣으면 비쌈
`callback_url`선택완료된 작업을 이 URL로 보냅니다.	URL	—	—	—

오류와 해결 방법

401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.

AI 앱에 Opennan 추가하기

한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.

MCP 서버https://api.opennan.com/v1/mcp

Codex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.

API 키 받기
콘솔에서 키를 만드세요. sk-로 시작하며 웹사이트와 같은 잔액을 씁니다.
키 만들기

키를 OPENNAN_KEY로 저장

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Opennan 플러그인 설치: 서버와 함께 모델 선택, 가격 확인, 결과 대기를 AI에게 알려 주는 스킬이 들어 있습니다
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

또는 서버만 추가

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

또는 ~/.codex/config.toml에 추가

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
opennan이 목록에 있는지 확인
```
codex mcp list
```
Codex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”

sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.

AI 에이전트에서 사용하기

에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.

도구: generate_video
예시 인수: { "model": "wan-2-2-fast", "prompt": "밤의 네온 거리에 내리는 비, 느린 푸시인", "duration": 5 }

영상 생성 API: 자주 묻는 질문

모든 모델과 가격

영상 생성 API 요금은 얼마인가요?

Wan 2.2 Fast로 480p에서 $0.0078/초부터이며, 여기 있는 17개 모델 중 가장 저렴합니다. 실행 전에 가격이 표시됩니다.

코드에서 어떻게 호출하나요?

API 키와 함께 POST https://api.opennan.com/v1/videos/generations를 보내세요. 작업 ID가 돌아오면 작업이 성공하거나 실패할 때까지 https://api.opennan.com/v1/tasks/{id}을 확인하세요.

코드를 바꾸지 않고 모델을 바꿀 수 있나요?

네. model 필드만 바꾸고 나머지 요청, 같은 키, 같은 잔액은 그대로 두면 됩니다.

AI 에이전트가 쓸 수 있나요?

네. MCP 서버 https://api.opennan.com/v1/mcp를 추가해 generate_video 도구를 호출하거나, 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요.

실행이 실패하면 어떻게 되나요?

실패한 실행은 청구되지 않습니다. 결과에 대해서만 결제합니다.