Video a audioAcerca de Video Sound Effects
Dale sonido a un clip mudo: la herramienta mira la imagen y genera efectos y ambiente que acompañan la acción, guiados por una descripción opcional, de hasta 30 segundos.
Llámalo con el nombre de modelo popnow/foley-v1/video-to-audio en POST /jobs/createTask, desde 1 crédito por un clip de 5 segundos (0,01 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 1 · ≤ 30 · Por defecto: 8 |
guidance_scale | No | Con qué rigor sigue el modelo el prompt. ≥ 0 · ≤ 20 · Por defecto: 4.5 |
ignore_visual_semantics | No | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Por defecto: false |
negative_prompt | No | Estilos o sonidos que no quieres en la pista. |
prompt | No | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | No | Más pasos dan más detalle, pero tardan más. ≥ 4 · ≤ 50 · Por defecto: 25 |
video_url | Sí | El clip con el que trabajar. |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| Estándar | 0,18 | 0,0018 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 1 crédito por un clip de 5 segundos (0,01 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Video Sound Effects en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model popnow/foley-v1/video-to-audio 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": "popnow/foley-v1/video-to-audio",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 8
}
}'
# 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 Video Sound Effects
¿Cuánto cuesta la API de Video Sound Effects?
Video Sound Effects cuesta 1 crédito (0,01 US$) por un clip de 5 segundos. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Video Sound Effects en la API?
Pon popnow/foley-v1/video-to-audio para Video a audio en el campo model de POST /jobs/createTask.
¿Tengo que describir el sonido?
No. Sin descripción, se envía una solicitud general de sonidos acordes con la acción en pantalla. Unas pocas palabras concretas suelen dar un resultado mejor.
¿Qué pasa con el sonido que ya tiene el clip?
El video entregado lleva la pista generada como audio, así que parte de un clip mudo o de uno cuyo sonido quieras reemplazar.
¿Qué límites tiene la API de Video Sound Effects?
Duración del clip: 1–30 s; Longitud del prompt (caracteres): 1,000; Subida máxima: 90 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Video Sound Effects sin escribir código?
Sí. El Playground ejecuta Video Sound Effects con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.