daVinci-MagiHuman 소개
daVinci-MagiHuman은 Sand.ai와 SII-GAIR의 오픈 모델로, 화면과 목소리를 함께 생성해요. 말할 대사를 따옴표로 묶으면 화면 속 인물이 그 말을 해요. 프롬프트나 시작 사진으로 5~10초 클립을 256p, 720p, 1080p의 16:9 또는 9:16으로 만들어요.
POST /jobs/createTask에서 모델 이름을 sand-ai/davinci-magihuman/image-to-video(으)로 지정하면 호출할 수 있습니다. US$0.12부터.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 기본값: 16:9 |
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. ≥ 5 · ≤ 10 · 기본값: 5 |
image_url | 예 | 출발점이 되는 이미지. |
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/image-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/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
daVinci-MagiHuman · 이미지로 영상 만들기 API의 제한은 무엇인가요?
영상 길이: 5–10 s; 해상도: 256p · 720p · 1080p; 화면 비율: 16:9 · 9:16; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.