Proporcionar archivos de entrada
Los modelos que aceptan una entrada de imagen, video o audio las leen como URLs HTTPS públicas dentro del objeto input — no hay un endpoint de subida aparte.
Cómo funcionan los archivos de entrada
Aloja el archivo en cualquier lugar que lo sirva por HTTPS público y luego referencia la URL en los campos input del modelo (por ejemplo image_url):
JSON
{
"model": "bytedance/seedance-2-image-to-video",
"input": {
"image_url": "https://your-cdn.example.com/photo.jpg",
"prompt": "cinematic slow push-in"
}
}Usar una URL alojada
El archivo ya está en línea — pasa la URL directamente
Desde datos Base64
Decodifícalo y guárdalo primero, luego pasa la URL
Desde un archivo local
Súbelo primero a tu propio almacenamiento, luego pasa la URL
Requisitos de la URL
- Accesible públicamente — sin inicio de sesión, cookies ni lista de IP permitidas delante.
- HTTPS con un certificado válido.
- Respuesta directa del archivo — la URL debe devolver los bytes del contenido (
Content-Typecorrecto), no una página de vista previa HTML. - Mantén los archivos de tamaño razonable; las fuentes muy grandes ralentizan la tarea o fallan en el upstream.
Autocomprobación rápida antes de enviar una tarea:
cURL
curl -I "https://your-cdn.example.com/photo.jpg"
# expect: HTTP/2 200 + Content-Type: image/jpegEjemplo de extremo a extremo
cURL
# 1) start the task, referencing your hosted file
curl -X POST "https://97ai.97claude.com/api/generate" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2-image-to-video",
"input": {
"image_url": "https://your-cdn.example.com/photo.jpg",
"prompt": "cinematic slow push-in"
}
}'
# → { "taskId": "task_12345678", "state": "waiting" }
# 2) poll until success / fail
curl "https://97ai.97claude.com/api/generate/task_12345678" \
-H "Authorization: Bearer $API_KEY"Dónde alojar los archivos
- Tu propio almacenamiento de objetos: AWS S3, Alibaba Cloud OSS, Tencent Cloud COS, Cloudflare R2 (bucket público o URL prefirmada)
- El CDN o servidor de archivos estáticos existente de tu app
- Cualquier servicio de alojamiento de imágenes/archivos que devuelva una URL de archivo directa
Las URLs prefirmadas funcionan
Las URLs prefirmadas con tiempo limitado (S3/OSS/COS) están bien — solo asegúrate de que sigan válidas unos minutos mientras se ejecuta la tarea.
Problemas comunes
- 403 / protección hotlink — el host bloquea solicitudes que no son de navegador; desactiva las comprobaciones de referer o usa URLs prefirmadas.
- HTML en vez del archivo — pasaste un enlace de página para compartir (Google Drive, cloud drive) en lugar de una URL de archivo directa.
- URLs de localhost / LAN —
http://localhost/…o IPs privadas no son accesibles desde la plataforma.
Soporte
Escribe a [email protected] o consulta las páginas específicas de cada modelo para ver sus campos input exactos.