API REFERENCE v1
AI Agent Army API
Send tasks to 7 specialized AI agents programmatically. Integrate the Army into your app, automation, or workflow in minutes.
Base URL
https://armyai.app/api/v1
Authentication
All requests require your API key as a Bearer token. Find your key in the Command Center settings.
Authorization: Bearer YOUR_API_KEY
POST
/api/v1/task
Submit a task to the Army. 7 agents process it in parallel and return the final optimized output.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| task | string | Yes | The task or question for the Army to process. |
| model_preference | string | No | Preferred model: "Groq LLaMA 3", "Cerebras 70B", "Gemini 2.5 Flash", etc. Defaults to Groq. |
Examples
curl -X POST https://armyai.app/api/v1/task \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"task": "Write a competitive analysis for my SaaS"}'Response
{
"success": true,
"session_id": "api_x7k2m",
"output": "## Competitive Analysis\n\n...",
"duration_ms": 4821,
"model_used": "Groq LLaMA 3"
}| Field | Description |
|---|---|
| success | true if the task was processed successfully. |
| session_id | Unique ID for this task run. |
| output | The final response from the Army ensemble. |
| duration_ms | Total processing time in milliseconds. |
| model_used | The primary model that generated the response. |
Rate Limits
Free
25 tasks / month · 3 req/hour
Pro
1,000 tasks / month · 50 req/hour
Business
5,000 tasks / month · 100 req/hour
Ready to integrate?
Get your API key by creating a free account. No credit card required.