AI
One door to several AI providers (Claude, local models, Mistral): chat, embeddings, OCR, summaries, judgments, images.
partAI32 operationsid ai
How it sits
A part does one thing, and any other part can call it. The counts and the links below are from the platform's spec and the other services' own descriptions.
| Operations | 32 GET 19 · POST 12 · DELETE 1 |
| Resources | 17 |
| Leaned on by | Billing, Executive assistant, Ingest, Knowledge base, Manim, Overseer, Scout, Search, SME interviews, Social |
| Leans on | none named |
| In recipes | Companies near home: find them, watch them, read their jobs and news; A region brief; A radio buy, ranked; A cited research dossier; An inbound text that updates a profile |
What it can do
32 operations in 17 resources, as the spec declares them. Each row is one call; paths are relative to the part.
usage
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/usage | Query usage records |
| GET | /api/v1/usage/series | Get time-bucketed usage series |
| GET | /api/v1/usage/summary | Get usage summary |
| DELETE | /api/v1/usage/{request_id} | Delete usage record |
| GET | /api/v1/usage/{request_id} | Get usage record by request ID |
5 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/health | Check all provider availability |
| GET | /api/v1/health/detailed | Per-provider detailed health (AI#93) |
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
4 operations
chat
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/chat | Chat with an AI model |
| POST | /api/v1/chat/agent | Server-side tool agent loop with SSE streaming |
| POST | /api/v1/chat/tools | Chat with tools (Claude, xAI, Gemini or local) |
3 operations
images
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/images/jobs | Start an image generation job |
| GET | /api/v1/images/jobs/{job_id} | Image job status |
| GET | /api/v1/images/jobs/{job_id}/image | Fetch a finished image |
3 operations
ocr
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/ocr | Extract text from documents (Mistral) |
| GET | /api/v1/ocr/ladder | Recent OCR ladder paths and path counts since start |
| POST | /api/v1/ocr/unstructured | Extract text from documents (Unstructured) |
3 operations
text
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/text/jobs | Summarize or extract topics as a job (submit, then poll) |
| GET | /api/v1/text/jobs/{job_id} | Text job status and result |
2 operations
traces
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/traces | List recent traces |
| GET | /api/v1/traces/{trace_id} | Get a full trace tree |
2 operations
root
| Method | Path | Does |
|---|---|---|
| GET | / | Service information |
1 operation
embed
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/embed | Generate text embeddings |
1 operation
imagelocate
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/imagelocate | Locate a target region (e.g. logo) in an image via Claude Vision |
1 operation
judge
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/judge | Typed judgments over a state (TypeSafe System One / jev) |
1 operation
model-cards.json
| Method | Path | Does |
|---|---|---|
| GET | /model-cards.json | Get Ollama model catalog |
1 operation
models
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/models | Models a cloud chat provider offers AI's key |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
summarize
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/summarize | Summarize text content |
1 operation
topics
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/topics | Extract main topics from content |
1 operation
All the partsAIThe platform's own id for this service is cbai.
forge-catalog.json, generated Nov 7, 2026