daVinci-MagiHuman API

About daVinci-MagiHuman

sand-ai/davinci-magihuman/image-to-video uses image_url as the first frame, so the face you send is the face in the clip. Keep the prompt on movement, expression and the quoted line.

Call it with the model name sand-ai/davinci-magihuman/image-to-video on POST /jobs/createTask, from $0.12.

Introduction

daVinci-MagiHuman Image to video starts a clip from your photo and gives it motion and a voice. daVinci-MagiHuman is an open 15-billion-parameter model from Sand.ai and SII-GAIR that generates the picture and the soundtrack together. The photo is the first frame; the prompt says what happens next and, in quotes, what the person says.

Choose a mode by starting material

Key features

A first frame that moves and speaks

The clip starts from your image.

What we measured

We ran two image-to-video clips at 720p and 16:9, both 5.0 seconds and both about 1358 x 678 at 25 fps, so 720p is not exactly 1280 x 720.

Resolutions and shapes

resolution is 256p, 720p (the default) or 1080p, and aspect_ratio is 16:9 (the default) or 9:16. The model generates at a low base resolution and its own super-resolution stage produces the higher tiers.

Request parameters

Pricing

Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

A character who says a line

A first-frame image and a short quoted line, to see how the character looks and sounds before you commit to more.

Vertical clips from a photo

Choose 9:16 for feeds and stories. All our runs on this endpoint used 16:9, so check a first clip.

Prompt guide & pro tips

Describe the next moment

Write what happens after the photo was taken: she turns to the camera, tucks her hair, speaks. In our run all three happened.

Without audio, quote the line

Put what the person says in quotation marks and the model speaks it. We tested English.

Choosing between models

Pick daVinci-MagiHuman when you want the model to speak a line you write, or you need a 9:16 clip.

API quick start

Call the daVinci-MagiHuman API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
2. Send the request. POST /jobs/createTask with model sand-ai/davinci-magihuman/image-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 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"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

About the daVinci-MagiHuman Image to Video endpoint

Our 720p runs at 16:9 came back at about 1358 by 678 with the face close to the input portrait. Pick a portrait whose framing already matches the shot you want.

Keep the quoted line short enough for the clip length. A line of about ten words suits a five-second take, and a longer one needs a longer duration.

Describe the expression as well as the motion, for example a half smile before the line. The photo already fixes the face, so the words in the prompt only decide how that face moves and when it speaks.

Only 16:9 and 9:16 are accepted here, as on text-to-video. The aspect value does not change the rate.

daVinci-MagiHuman API questions

More about daVinci-MagiHuman

Try it

daVinci-MagiHuman AI Video Generator onlineCreate videos with daVinci-MagiHuman in PopNow

Endpoints

All daVinci-MagiHuman endpoints and pricing

Endpoints

daVinci-MagiHuman · Create Video

Docs

daVinci-MagiHuman model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get daVinci-MagiHuman results without polling