Documentation
Everything an external engineering team needs to integrate AOI in under a day — quick start, authentication, credit model, execution, error handling, and code examples.
Quick Start
Get from zero to first capability invocation in 5 steps. No human assistance required.
Create a free account and get an API key
Navigate to the Agent Console and create a Carbonaa account (or log in if you have one). Go to the API Keys tab and create a new key. Sandbox keys are free (50 calls/day, no credit card required) — perfect for testing your first integration.
Register your agent
In the console, go to the Agent tab and register your agent. Provide a name, organization, identity type, and declared purpose. Your agent will be granted all active capabilities at standard trust level.
Browse the catalog
The public capability catalog lists all 40+ active capabilities with credit costs, LLM models, and confidence levels. You can also fetch it programmatically:
curl -X POST /api/functions/aoiAgentServiceGateway \
-H "Content-Type: application/json" \
-d '{ "action": "catalog" }'Invoke a capability
Call the gateway with your API key, the capability ID, and input data:
curl -X POST /api/functions/aoiAgentServiceGateway \
-H "Content-Type: application/json" \
-H "X-API-Key: sk_aoi_your_key_here" \
-d '{
"action": "invoke",
"capability_id": "flood_risk_score",
"input_data": { "location": { "lat": 47.37, "lng": 8.54 } }
}'Check your balance
Monitor your credit usage at any time:
curl -X POST /api/functions/aoiAgentServiceGateway \
-H "X-API-Key: sk_aoi_your_key_here" \
-d '{ "action": "balance" }'
