Riferimento API di Video Sound Effects

Con una sola chiave API di PopNow chiami Video Sound Effects dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: PopNow
Risultato: Audio
Da: 0.18 crediti per secondo generato ($0.0018)
ID del modello: popnow/foley-v1/video-to-audio

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Da video ad audio

popnow/foley-v1/video-to-audio

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`Predefinito`	0.18	$0.0018

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`video_url`Obbligatorio	`string`	—	—	Clip to add sound to. The picture is kept; the returned clip carries the generated sound as its audio.
`prompt`Facoltativo	`string`	—	fino a 1000 caratteri	The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used.
`duration_seconds`Facoltativo	`integer`	`8`	da 1 a 30	Seconds of sound to generate, from 1 to 30. The returned clip is cut to this length and these seconds are billed.
`negative_prompt`Facoltativo	`string`	—	fino a 1000 caratteri	Sounds to keep out, such as music or speech.
`ignore_visual_semantics`Facoltativo	`boolean`	`false`	—	Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion.
`guidance_scale`Facoltativo	`number`	`4.5`	da 0 a 20	How closely the sound follows the description, from 0 to 20.
`steps`Facoltativo	`integer`	`25`	da 4 a 50	Refinement passes, from 4 to 50. More passes take longer.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask

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": "popnow/foley-v1/video-to-audio",
  "input": {
    "prompt": "Soft wind, rustling petals and distant birdsong",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 8
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"