Skip to main content
POST
El Playground de la documentación no admite la subida de archivos: Por favor, utilice los ejemplos de código cURL, Python o JavaScript que aparecen a continuación para probar.
Almacenamiento temporal: Las imágenes subidas solo se conservan durante 72 horas. Después de ese periodo, la URL de la imagen dejará de ser válida. Utilice la imagen dentro de ese plazo o guárdela a tiempo en su propio servicio de almacenamiento.
Cambio importante: Para un mejor rendimiento y control de costos, ya no admitimos el envío de datos de imagen en base64 directamente en las APIs de generación. Por favor, utilice esta API para subir las imágenes, obtenga la URL y luego llame a la API de generación.

¿Por qué subir las imágenes primero?

  1. Optimización de rendimiento - La codificación base64 aumenta los datos en un 33%; subir primero reduce considerablemente el tamaño del cuerpo de la solicitud
  2. Reutilización de imágenes - Suba una vez y reutilice la URL múltiples veces sin transferencias redundantes

Flujo de trabajo

Autorizaciones

string
requerido
Todas las APIs requieren autenticación mediante Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a los encabezados de la solicitud:

Body

file
requerido
Archivo de imagenFormatos admitidos: JPEG (.jpg, .jpeg), PNG (.png), WebP (.webp), GIF (.gif)Tamaño máximo del archivo: 20MB

Respuesta

string
URL de acceso público a la imagen; puede utilizarse directamente en las APIs de generación (válida durante 72 horas)
string
Nombre original del archivo
string
Tipo MIME detectado, por ejemplo image/jpeg
integer
Tamaño del archivo en bytes
integer
Hora de subida como timestamp Unix (segundos)

Ejemplo completo: flujo de imagen a imagen

Python