MercadoSoporte← Volver a la app

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-Type correcto), 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/jpeg

Ejemplo 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 / LANhttp://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.