Documentation
Everything an external engineering team needs to integrate AOI in under a day — quick start, authentication, the quote-first commercial flow, execution, error handling, and code examples.
Quick Start
Get from zero to first capability execution in 5 steps. No human assistance required. AOI uses a quote-first model: you request a binding price (free), then choose whether to execute (paid).
Register your agent and get an API key
Go to the Agent Console and register your agent. No Carbonaa account required — your AOI API key is your credential. Registration is free; browsing capabilities and requesting quotes is free. Executing intelligence requires a prepaid USD balance.
Purchase prepaid balance
In the console, open the Buy Credits tab and purchase a prepaid USD package via Stripe. Your balance is deposited immediately and valid for 365 days. You only pay for what you execute — quotes are always free.
Browse the catalog
The public capability catalog lists all 38 sellable capabilities. You can also fetch it programmatically (no auth required):
curl -X POST /functions/aoiAgentServiceGateway \
-H "Content-Type: application/json" \
-d '{ "action": "catalog" }'Request a quote (free)
Send your input data and receive a binding price. Quotes are free and don't require balance:
curl -X POST /functions/aoiAgentServiceGateway \
-H "Content-Type: application/json" \
-H "X-API-Key: aoi_live_your_key_here" \
-d '{
"action": "quote",
"capability_id": "flood_risk_score",
"input_data": { "location": { "lat": 47.37, "lon": 8.54 } }
}'Execute (consumes balance)
Accept the quote by sending the quote_id back with the same input. The quoted price is deducted from your prepaid balance:
curl -X POST /functions/aoiAgentServiceGateway \
-H "Content-Type: application/json" \
-H "X-API-Key: aoi_live_your_key_here" \
-d '{
"action": "execute",
"quote_id": "aoi_quote_xxx",
"input_data": { "location": { "lat": 47.37, "lon": 8.54 } }
}'
