API Endpoints
| POST /v1/chat/completions | Chat — OpenAI-compatible |
| GET /v1/models | List available models |
| POST /v1/embeddings | Text embeddings |
| GET /v1/health | Health check (no auth) |
| GET /.well-known/agent.json | A2A Agent Card |
| GET /portal/api/compliance/report | Compliance report |
| GET /portal/api/otrs/dashboard | OTRS live dashboard |
Authentication
| Authorization: Bearer {key} | API key auth |
| Content-Type: application/json | Required for POST |
curl https://api.iio.space/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen2.5:7b","messages":[{"role":"user","content":"Hello"}]}'
Available Models
| qwen2.5:7b | Free · ~250ms · Best allround |
| llama3.2:3b | Pro · ~100ms · Fastest |
| mistral:7b | Pro · ~220ms · EU-origin |
| gemma2:9b | Pro · ~300ms · Good QA |
| llama3.1:70b | Enterprise · ~800ms · Best quality |
Python SDK
pip install iio-governance
pip install iio-governance[langchain] # + LangChain
from iio_governance import (
HITLGate, PolicyCheck,
AuditTrail, ComplianceCheck
)
# HITL Gate
gate = HITLGate(api_url="https://api.iio.space")
result = gate.check("gate.production-deploy")
# result.status: "approved" | "pending" | "blocked"
# Policy
report = PolicyCheck(...).run()
# report.passed, report.failed, report.ok
# Compliance
cc = ComplianceCheck(...).check_eu_ai_act()
# cc.classification: "Limited Risk"
TypeScript SDK
npm install @iio/governance
import { HITLGate, PolicyCheck } from '@iio/governance';
const gate = new HITLGate({
baseUrl: 'https://api.iio.space',
apiKey: process.env.IIO_API_KEY!
});
const result = await gate.check('gate.production-deploy');
if (result.status !== 'approved') throw new Error('Gate blocked');
CLI Commands
| iio gate check {gate-id} | Check gate status |
| iio policy check | Run policy checks |
| iio policy check --format json | JSON output |
| iio audit query --last 24h | Query audit events |
| iio compliance report | Full compliance report |
| iio models list | List available models |
IIO Operator Commands
| session-start.sh | Start session (register scope) |
| session-closeout.sh | Close session (evidence) |
| policy-check.sh | Run 23 governance checks |
| agent-update-task.sh | Update task + scope |
| ops-fast-lane.sh doctor | Health check |
HITL Gate IDs
| gate.production-deploy | Deployment approval |
| gate.campaign-stage-advance | Campaign stage gate |
| gate.avv-signature-confirm | Contract signing |
| gate.developer-api-key-approve | API key issuance |
| gate.content-publish-social | Social media post |
| gate.customer-go-live-approve | Tenant onboarding |
| gate.minor-release-approve | Minor release gate |
| gate.major-release-approve | Major release (dual) |