Subida de Im谩genes
POST/api/upload
Carga una imagen al servidor. Soporta formatos JPEG, JPG, PNG, GIF y WebP.
Par谩metros
| Par谩metro | Tipo | Descripci贸n |
|---|---|---|
| image | File | Archivo de imagen a subir (JPEG, PNG, GIF, WebP) |
Respuesta Exitosa (200):
{
"url": "http://bana1min.eivannor.com:3000/uploads/1234567890-imagen.jpg"
}
Editor de Im谩genes
POST/api/image-editor
Edita una imagen usando IA. Permite especificar cambios y referencias visuales.
Par谩metros (Body JSON)
| Par谩metro | Tipo | Requerido | Descripci贸n |
|---|---|---|---|
| imageUrl | String | S铆 | URL de la imagen a editar |
| prompt | String | S铆 | Descripci贸n de los cambios deseados |
| referenceImage1 | String | No | URL de imagen de referencia 1 |
| referenceImage2 | String | No | URL de imagen de referencia 2 |
| referenceImage3 | String | No | URL de imagen de referencia 3 |
Ejemplo de Solicitud:
curl -X POST "http://localhost:3000/api/image-editor" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/image.jpg",
"prompt": "Cambia el fondo a azul",
"referenceImage1": "https://example.com/ref1.jpg"
}'
Chat con IA
POST/api/chat-with-ai?isStreaming=true
Inicia una conversaci贸n con un modelo de IA. Soporta respuestas en tiempo real con streaming.
Par谩metros de Query
| Par谩metro | Tipo | Descripci贸n |
|---|---|---|
| isStreaming | Boolean | Si es "true", devuelve respuesta en streaming (SSE). Default: false |
Par谩metros (Body JSON)
| Par谩metro | Tipo | Requerido | Descripci贸n |
|---|---|---|---|
| prompt | String | S铆 | Tu pregunta o mensaje para la IA |
| model | String | No | Modelo a usar. Default: "o3-mini" |
| webSearch | Boolean | No | Habilitar b煤squeda en web. Default: false |
Ejemplo de Solicitud (Sin Streaming):
curl -X POST "http://localhost:3000/api/chat-with-ai" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Cu茅ntame sobre inteligencia artificial",
"model": "o3-mini",
"webSearch": false
}'
Ejemplo de Solicitud (Con Streaming):
curl -X POST "http://localhost:3000/api/chat-with-ai?isStreaming=true" \
-H "Content-Type: application/json" \
-d '{
"prompt": "驴Cu谩les son las aplicaciones de la IA?",
"model": "o3-mini"
}'
Informaci贸n General
Autenticaci贸n
La autenticaci贸n se realiza mediante la clave API almacenada en la variable de entorno API_KEY en el servidor.
C贸digos de Estado HTTP
| C贸digo | Significado |
|---|---|
| 200 | Solicitud exitosa |
| 400 | Solicitud inv谩lida (par谩metros faltantes o incorrectos) |
| 500 | Error interno del servidor |