daVinci-MagiHuman API reference
Put a line in quotes and the person on screen says it
Call daVinci-MagiHuman from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.
At a glance
- Made by
- Sand.ai
- Output
- Video
- From
- $0.024 USD per second of output
- Typical time
- about 223 s
Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.
Create Video
sand-ai/davinci-magihuman/text-to-video
Price
| Option | USD |
|---|---|
256p | $0.024 per second of output |
720p | $0.048 per second of output |
1080p | $0.072 per second of output |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | What happens, and in quotes what the person says. The model speaks quoted lines itself. |
audio_urlOptional | string (uri) | — | — | Optional speech or song (MP3 or WAV). When given, the clip is generated in sync with it instead of a voice the model writes. |
aspect_ratioOptional | string | 16:9 | 16:9, 9:16 | Output aspect ratio. |
resolutionOptional | string | 720p | 256p, 720p, 1080p | Output resolution. The model generates at a low base size and upscales with its own super-resolution stage; higher tiers cost more per second. |
duration_secondsOptional | integer | 5 | 5 to 10 | Clip length in whole seconds, 5 to 10. Billed per second. |
seedOptional | integer | — | 0 to 2147483647 | Random seed for controlled comparisons. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
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: $(uuidgen)" \
-d '{
"model": "sand-ai/davinci-magihuman/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
"duration_seconds": 5,
"resolution": "720p"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Image to Video
sand-ai/davinci-magihuman/image-to-video
Price
| Option | USD |
|---|---|
256p | $0.024 per second of output |
720p | $0.048 per second of output |
1080p | $0.072 per second of output |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | What happens, and in quotes what the person says. The model speaks quoted lines itself. |
image_urlRequired | string (uri) | — | — | The first frame: the clip starts from this image. |
audio_urlOptional | string (uri) | — | — | Optional speech or song (MP3 or WAV). When given, the clip is generated in sync with it instead of a voice the model writes. |
aspect_ratioOptional | string | 16:9 | 16:9, 9:16 | Output aspect ratio. |
resolutionOptional | string | 720p | 256p, 720p, 1080p | Output resolution. The model generates at a low base size and upscales with its own super-resolution stage; higher tiers cost more per second. |
duration_secondsOptional | integer | 5 | 5 to 10 | Clip length in whole seconds, 5 to 10. Billed per second. |
seedOptional | integer | — | 0 to 2147483647 | Random seed for controlled comparisons. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
The example uses PopNow sample files in image_url. Replace them with your own public HTTPS links, uploads or saved assets.
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: $(uuidgen)" \
-d '{
"model": "sand-ai/davinci-magihuman/image-to-video",
"input": {
"prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"duration_seconds": 5,
"resolution": "720p"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"