Video-to-Audio API: elige el resultado y construye el flujo de procesamiento correcto

Referencia acepta multipart/form-data, exactamente uno de video/video_url, y optional music_prompt/sfx_prompt. Timed segments controlan SFX. Devuelve 202 con task_id.

curl -X POST https://api.sonilo.com/v1/video-to-sound  -H "Authorization: Bearer $SONILO_API_KEY"  -F "video_url=https://media.example/authorized-clip.mp4"  -F "music_prompt=warm pulse, room for narration"  -F "sfx_prompt=natural product clicks, no voice"

No JSON, no manual multipart boundary y no archivo+URL juntos. Valida URL/carga antes de billable función. URL signed no es automáticamente segura: debe resolver al medios y no permitir private-network fetch.

Instrucción solo para intent

Video aporta sincronización/escena. Instrucción limita style, material, density, espacio para el diálogo o exclusiones; no narra cada fotograma. Separa música/SFX. Valida segments, order, boundaries y duración contra probe local antes de submit.

Guarda ID de tarea con servidor función ID, authenticated owner, endpoint, normalized fuente fingerprint y timestamp. Poll GET https://api.sonilo.com/v1/tasks/{task_id} cada pocos segundos. Estados: processing, succeeded, failed. Combined dar la operación por terminada puede incluir output_url/type/datos, content type, música/SFX pistas separadas y resultados array. No asumas que todo devuelve audio.url.

1. Usa deadline y bounded attempts.
2. Respeta Retry-After en 429.
3. Failed conserva code/message sin placeholder.
4. Succeeded requiere HTTPS allowed URL, expected type y positive byte count.
5. Descarga con max size, calcula hash, medios-probe y persiste si URL temporal expirará.
6. Stop polling no significa cancel upstream.

Valida redirects, loopback, link-local, private y metadata addresses; limita schemes y revalida fetch para DNS rebinding. No forward arbitrary headers. Biometric, child, confidential o regulated footage requiere privacidad/legal especializado.

Timeout no prueba submit failure. Antes de Sonilo crea idempotency gate con owner, endpoint, fuente hash, instrucciones, segments/opciones; guarda pending función transactionally y devuelve existing función en duplicados. No repitas POST a ciegas.

Consulta servicios de la cuenta, queue local, per-user cuotas/cost ceilings y registro duración/variants. User cancel puede detener espera local, pero current documentación no ofrecen dedicated cancel y task sigue billable.

HTTP dar la operación por terminada solo confirma recurso. Dataset autorizado: diálogo demo, fast cortes, interview, UI, physical acción, ambiente e intentional silence.

Usa human rubric, no solo metrics. Prueba combined resultado en real player/editor e inspecciona pistas separadas. Publicación requiere technical y creative acceptance.

Antes de carga aclara control de video, faces, voices, performances, logos, locations y embedded audio. Conserva cuenta/workspace, commercial basis, endpoint, task, fecha, fuente ID/hash, instrucciones/segments, resultado IDs/hashes, type, revisor, project/cliente, territorios/channels, versiones editadas y publicación decision. Revisa licencias en generación y publication.

No digas copyright-free, exclusive titularidad o legal autorización solo porque API respondió. Haz similitud/marca revisión y dirige medios de pago, clientes, distribución, sublicensing/producto embed a qualified counsel.

1. Contract distingue audio/video, mezcla/pistas separadas y content types.
2. Ejecución usa api.sonilo.com/v1, nunca documentación URL.
3. Clave del lado del servidor y fuera de logs/cliente.
4. Caller, workspace, autorización, URL, datos, duración y formato validados.
5. Duplicate gate, queue, quota, balance, timeout/backoff probados.
6. Task estado guardado; polling bounded; 429 respeta header.
7. Dar la operación por terminada exige datos reales, probe, type/duración/channels/hash.
8. Eval cubre sincronización, silence, diálogo, devices y edge cases.
9. Licencias, privacidad, retención, deletion, similitud y aprobación documentados.
10. Dashboard observa latency, failures, duplicates, cost y quality rejects sin leaking medios.