동영상 만들기
이미지로 영상 만들기daVinci-MagiHuman 소개
daVinci-MagiHuman은 Sand.ai와 SII-GAIR의 오픈 모델로, 화면과 목소리를 함께 생성해요. 말할 대사를 따옴표로 묶으면 화면 속 인물이 그 말을 해요. 프롬프트나 시작 사진으로 5~10초 클립을 256p, 720p, 1080p의 16:9 또는 9:16으로 만들어요.
POST /jobs/createTask에서 모델 이름을 sand-ai/davinci-magihuman/text-to-video(으)로 지정하면 호출할 수 있습니다. US$0.12부터.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 기본값: 16:9 |
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. ≥ 5 · ≤ 10 · 기본값: 5 |
prompt | 예 | What happens, and in quotes what the person says. The model speaks quoted lines itself. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 256p · 720p · 1080p · 기본값: 720p |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
가격
요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
| 옵션 | USD /초 |
|---|---|
| resolution 256p | US$0.024 |
| resolution 720p | US$0.048 |
| resolution 1080p | US$0.072 |
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
daVinci-MagiHuman API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
- 요청 보내기. POST /jobs/createTask에 model은 sand-ai/davinci-magihuman/text-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "sand-ai/davinci-magihuman/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
daVinci-MagiHuman API 질문
daVinci-MagiHuman API 요금은 얼마인가요?
daVinci-MagiHuman 가격은 가장 저렴한 동영상 만들기 기준 US$0.12 / 5초 영상부터입니다. 옵션별 가격: 256p US$0.024/초, 720p US$0.048/초, 1080p US$0.072/초. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
API에서 daVinci-MagiHuman의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 동영상 만들기: sand-ai/davinci-magihuman/text-to-video; 이미지로 영상 만들기: sand-ai/davinci-magihuman/image-to-video을(를) 넣으세요.
daVinci-MagiHuman은 무엇인가요?
Sand.ai와 SII-GAIR가 함께 만든 150억 파라미터 모델이며, 오픈 가중치가 Apache 2.0으로 공개되었습니다. 논문은 2026년 3월 23일에 발표되었습니다. 영상과 오디오를 한 번의 과정으로 함께 만들기 때문에 요청 하나에 화면과 사운드트랙이 함께 돌아옵니다. 카메라 앞에서 말하거나 노래하는 인물을 위해 만들어졌고, 일반적인 장면도 다룹니다.
인물이 어떤 언어로 말할 수 있나요?
출품사는 중국어(만다린·광둥어), 영어, 일본어, 한국어, 독일어, 프랑스어를 제시합니다. 저희는 영어로 테스트했으니, 다른 언어는 첫 실행으로 먼저 확인하십시오.
인물에게 특정 대사를 말하게 하려면 어떻게 하나요?
프롬프트에서 대사를 따옴표 안에 넣으십시오. 모델은 따옴표 안의 대사를 직접 말합니다. 따옴표 대사를 넣은 저희 실행 세 개에서, 사운드트랙을 받아 적은 결과가 프롬프트와 한 단어도 틀리지 않게 일치했습니다.
클립은 얼마나 길고 얼마나 큰가요?
5~10초(기본값 5초)이며 256p, 720p(기본값) 또는 1080p, 16:9 또는 9:16입니다. 모델은 낮은 기본 해상도로 렌더링하고, 자체 초해상도 단계가 상위 해상도를 만듭니다. 저희 실행에서 720p 16:9는 약 1358 x 678, 720p 9:16은 약 726 x 1270, 1080p 16:9는 약 1904 x 1088이 나왔으며, 모두 25 fps였습니다.
같은 seed면 같은 클립이 나오나요?
같은 입력과 고정된 seed면 비슷한 결과가 나오며, 똑같은 결과는 보장되지 않습니다. 한 번에 하나씩만 바꾸면서 실행을 비교할 때 쓰십시오.
daVinci-MagiHuman API의 제한은 무엇인가요?
영상 길이: 5–10 s; 해상도: 256p · 720p · 1080p; 화면 비율: 16:9 · 9:16; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 daVinci-MagiHuman을(를) 써 볼 수 있나요?
API 키 없이 Playground에서 API 달러 잔액으로 daVinci-MagiHuman을(를) 실행할 수 있습니다. 실행마다 해당 코드와 함께 개발자 기록에 저장됩니다.
