API Reference

Everything you need to integrate AICoreCola agents, skills, and models into your application.

Authentication

All requests require a Bearer token in the Authorization header. Get your API key from the Dashboard.

Authorization: Bearer acc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Quick Start

curl https://api.aicorecola.com/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "core-sonnet",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Endpoints

POST/v1/chatModel

Send messages to any CoreMind model. Compatible with standard chat completion format.

Request Body
{
  "model": "core-sonnet",
  "messages": [
    { "role": "user", "content": "Hello!" }
  ],
  "max_tokens": 1024
}
Response
{
  "id": "msg_01abc",
  "model": "core-sonnet",
  "content": "Hello! How can I help you today?",
  "usage": { "input_tokens": 10, "output_tokens": 12 }
}
POST/v1/agents/jarvisAgent

Run the JARVIS autonomous agent on a multi-step task. The agent plans, uses tools, and returns a complete result.

Request Body
{
  "task": "Research the top 5 AI companies in 2025 and summarize their products",
  "max_steps": 10
}
Response
{
  "id": "task_02xyz",
  "status": "completed",
  "result": "# Top 5 AI Companies in 2025\n\n...",
  "steps_used": 7,
  "cost": 1.00
}
POST/v1/skills/researchSkill

Deep web research skill. Searches the web, reads sources, and returns a structured research report.

Request Body
{
  "query": "Latest developments in quantum computing 2025",
  "format": "markdown",
  "depth": "deep"
}
Response
{
  "id": "skill_03qrs",
  "report": "# Quantum Computing in 2025\n\n...",
  "sources": ["https://...", "https://..."],
  "cost": 0.50
}
POST/v1/skills/reportSkill

Generate a formatted document (PDF, Word, Excel, Markdown) from content or instructions.

Request Body
{
  "title": "Q4 Sales Report",
  "content": "Q4 revenue was $2.4M, up 32% YoY...",
  "format": "pdf"
}
Response
{
  "id": "doc_04abc",
  "download_url": "https://api.aicorecola.com/v1/files/doc_04abc.pdf",
  "expires_at": "2025-12-01T00:00:00Z",
  "cost": 0.50
}

Models & Agents

IDNameTypeContextPriceDescription
core-sonnetCoreMind SonnetModel200K$0.003 / 1K tokensBest reasoning, analysis, and code. Our most capable general-purpose model.
core-flashCoreMind FlashModel100K$0.001 / 1K tokensUltra-fast responses. Ideal for high-volume tasks and latency-sensitive apps.
core-visionCoreMind VisionModel100K$0.004 / 1K tokensImage + text understanding. Analyze documents, charts, and screenshots.
jarvis-agentJARVIS AgentAgent—$1.00 / taskAutonomous multi-step agent. Plans and executes complex tasks end-to-end.
research-skillResearch SkillSkill—$0.50 / reportWeb research + synthesis. Returns structured reports with cited sources.
report-skillReport GeneratorSkill—$0.50 / docGenerate PDF, Word, Excel, or Markdown documents from natural language.

Error Codes

401UnauthorizedMissing or invalid API key.
402Insufficient CreditsYour account balance is too low. Top up to continue.
429Rate LimitedToo many requests. Please slow down.
500Internal ErrorSomething went wrong on our end. Please retry.
Ready to start building?
Get your API key and $1 free credit in 60 seconds.
Get API Key →