AI Agent API
Integra asistente inteligente con IA, generación de contenido, búsqueda web y creación de imágenes en tus aplicaciones con nuestra API RESTful.
Colección Postman
Importe endpoints directamente a Postman para pruebas fáciles
Comenzando con AI Agent API
Integra asistente inteligente con IA, generación de contenido y búsqueda web en tus aplicaciones
Autenticación
Todas las solicitudes de API deben incluir tu clave API en el encabezado de Autorización usando el formato de token Bearer.
Authorization: Bearer YOUR_API_KEYCosto de Crédito
Cada 10 solicitudes de API consumen 1 crédito de tu saldo de cuenta.
Endpoints Disponibles
Crear Solicitud de Agente
Envía una consulta al agente de IA y recibe un ID de solicitud único para seguimiento.
POST
/api/v1/agentAutenticación Requerida
Inicia sesión para acceder a tus claves API, gestionar endpoints del agente de IA y seguir tu uso.
Solicitud de Ejemplo
curl -X POST http://localhost:11000/api/v1/agent \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "What is the latest news about AI?",
"language": "en",
"fileUrl": "https://example.com/photo.jpg",
"messageHistory": [
{ "role": "user", "content": "Tell me about AI" },
{ "role": "assistant", "content": "AI refers to..." }
]
}'Respuesta de Ejemplo
{
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "pending",
"message": "Request queued successfully. Use GET /api/v1/agent/:requestId to check status."
}Obtener Resultado de Solicitud
Recupera el estado y la respuesta de una solicitud creada previamente usando su UUID.
GET
/api/v1/agent/:uuidAutenticación Requerida
Inicia sesión para acceder a tus claves API, gestionar endpoints del agente de IA y seguir tu uso.
Solicitud de Ejemplo
curl -X GET http://localhost:11000/api/v1/agent/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer YOUR_API_KEY"Respuesta de Ejemplo
{
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"createdAt": "2026-01-25T10:30:00Z",
"completedAt": "2026-01-25T10:30:15Z",
"response": {
"message": "The latest AI developments include...",
"conversationUuid": "...",
"selectedMcps": ["web-search"],
"executionTime": 1500
},
"thinking": [...],
"selectedMcps": ["web-search"],
"safetyCheck": { "safety": 1.0, "requestedTools": {...} },
"usage": { "promptTokens": 150, "completionTokens": 200, "totalTokens": 350 },
"credit": { "used": 0.1, "cost": 0.01 }
}