AI Agent API

Sign In

AI Agent API

Integrate AI-powered intelligent assistant, content generation, web search, and image creation into your applications with our RESTful API.

Postman Collection

Import endpoints directly into Postman for easy testing

Download Collection
Getting Started with AI Agent API
Integrate AI-powered intelligent assistant, content generation, and web search into your applications
Authentication

All API requests must include your API key in the Authorization header using Bearer token format.

Authorization: Bearer YOUR_API_KEY

Credit Cost

Every 10 API requests consume 1 credit from your account balance.

Available Endpoints

Create Agent Request
Send a query to the AI agent and receive a unique request ID for tracking.
POST
/api/v1/agent

Authentication Required

Sign in to access your API keys, manage AI agent endpoints, and track your usage.

Sign InSign Up

Example Request

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..." }
    ]
  }'

Example Response

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Request queued successfully. Use GET /api/v1/agent/:requestId to check status."
}
Get Request Result
Retrieve the status and response of a previously created request using its UUID.
GET
/api/v1/agent/:uuid

Authentication Required

Sign in to access your API keys, manage AI agent endpoints, and track your usage.

Sign InSign Up

Example Request

curl -X GET http://localhost:11000/api/v1/agent/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "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 }
}