Acerca de daVinci-MagiHuman
daVinci-MagiHuman, un modelo abierto de Sand.ai y SII-GAIR, genera la imagen y la voz a la vez: pon una frase hablada entre comillas y la persona en pantalla la dice. Crea clips de 5 a 10 segundos a partir de un prompt o de una foto inicial, en 256p, 720p o 1080p, en 16:9 o 9:16.
Llámalo con el nombre de modelo sand-ai/davinci-magihuman/image-to-video en POST /jobs/createTask, desde 0,12 US$.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · Por defecto: 16:9 |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 5 · ≤ 10 · Por defecto: 5 |
image_url | Sí | La imagen de partida. |
prompt | Sí | What happens, and in quotes what the person says. The model speaks quoted lines itself. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 256p · 720p · 1080p · Por defecto: 720p |
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
Precios
Los precios se indican en USD. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.
| Opción | USD por segundo |
|---|---|
| resolution 256p | 0,024 US$ |
| resolution 720p | 0,048 US$ |
| resolution 1080p | 0,072 US$ |
Antes de ejecutar, envía el mismo cuerpo de petición a POST /jobs/quote para consultar el coste estimado y el máximo en USD. El presupuesto no ejecuta tareas ni carga tu saldo.
Inicio rápido de la API
Llama a la API de daVinci-MagiHuman en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola API. Las claves empiezan por sk-popnow-. Las llamadas utilizan tu saldo independiente en dólares estadounidenses.
- Envía la solicitud. Haz POST /jobs/createTask con model sand-ai/davinci-magihuman/image-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 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"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de daVinci-MagiHuman
¿Cuánto cuesta la API de daVinci-MagiHuman?
daVinci-MagiHuman cuesta desde 0,12 US$ por un clip de 5 segundos con Imagen a video, su tarea más barata. Precios por opción: 256p 0,024 US$ por segundo, 720p 0,048 US$ por segundo, 1080p 0,072 US$ por segundo. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.
¿Qué límites tiene la API de daVinci-MagiHuman · Imagen a video?
Duración del clip: 5–10 s; Resoluciones: 256p · 720p · 1080p; Relaciones de aspecto: 16:9 · 9:16; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.