58f88a83e4
Batch 3 (last) of the locale-expansion plan: ha, yo, ig, am, uz, ka, hy on every surface â dashboard catalog, docs mirror (22-file core + llm.txt + CHANGELOG), CLI catalog, README flag block, locale tables and đ language bars. Also closes the key gap the batch-1 (43 keys) and batch-2 (10 keys) catalogs carried since their base merges, fixes the Igbo "Model" copy and allowlists the Uzbek cognate. Translation-ratio baseline covers 65 locales. â ď¸ base-red inherited: #12732
202 KiB
API_REFERENCE (áĽáá ááŁáá)
đ Languages: đşđ¸ English ¡ đŞđš am ¡ đ¸đŚ ar ¡ đŚđż az ¡ đ§đŹ bg ¡ đ§đŠ bn ¡ đ¨đż cs ¡ đŠđ° da ¡ đŠđŞ de ¡ đŹđˇ el ¡ đŞđ¸ es ¡ đŞđŞ et ¡ đŽđˇ fa ¡ đŤđŽ fi ¡ đŤđˇ fr ¡ đŽđŞ ga ¡ đŽđł gu ¡ đłđŹ ha ¡ đŽđą he ¡ đŽđł hi ¡ đđˇ hr ¡ đđş hu ¡ đŚđ˛ hy ¡ đŽđŠ id ¡ đłđŹ ig ¡ đŽđš it ¡ đŻđľ ja ¡ đ°đ km ¡ đŽđł kn ¡ đ°đˇ ko ¡ đąđš lt ¡ đąđť lv ¡ đŽđł ml ¡ đŽđł mr ¡ đ˛đž ms ¡ đ˛đš mt ¡ đ˛đ˛ my ¡ đłđľ ne ¡ đłđą nl ¡ đłđ´ no ¡ đŽđł or ¡ đŽđł pa ¡ đľđ phi ¡ đľđą pl ¡ đľđš pt ¡ đ§đˇ pt-BR ¡ đˇđ´ ro ¡ đˇđş ru ¡ đąđ° si ¡ đ¸đ° sk ¡ đ¸đŽ sl ¡ đˇđ¸ sr ¡ đ¸đŞ sv ¡ đ°đŞ sw ¡ đŽđł ta ¡ đŽđł te ¡ đšđ th ¡ đšđˇ tr ¡ đşđŚ uk-UA ¡ đľđ° ur ¡ đşđż uz ¡ đťđł vi ¡ đłđŹ yo ¡ đ¨đł zh-CN ¡ đšđź zh-TW
title: "API áŞááááá á" version: 3.8.51 lastUpdated: 2026-08-31
API áŞááááá á
đ Languages: đşđ¸ English ¡ đŞđš am ¡ đ¸đŚ ar ¡ đŚđż az ¡ đ§đŹ bg ¡ đ§đŠ bn ¡ đ¨đż cs ¡ đŠđ° da ¡ đŠđŞ de ¡ đŹđˇ el ¡ đŞđ¸ es ¡ đŞđŞ et ¡ đŽđˇ fa ¡ đŤđŽ fi ¡ đŤđˇ fr ¡ đŽđŞ ga ¡ đŽđł gu ¡ đłđŹ ha ¡ đŽđą he ¡ đŽđł hi ¡ đđˇ hr ¡ đđş hu ¡ đŚđ˛ hy ¡ đŽđŠ id ¡ đłđŹ ig ¡ đŽđš it ¡ đŻđľ ja ¡ đ°đ km ¡ đŽđł kn ¡ đ°đˇ ko ¡ đąđš lt ¡ đąđť lv ¡ đŽđł ml ¡ đŽđł mr ¡ đ˛đž ms ¡ đ˛đš mt ¡ đ˛đ˛ my ¡ đłđľ ne ¡ đłđą nl ¡ đłđ´ no ¡ đŽđł or ¡ đŽđł pa ¡ đľđ phi ¡ đľđą pl ¡ đľđš pt ¡ đ§đˇ pt-BR ¡ đˇđ´ ro ¡ đˇđş ru ¡ đąđ° si ¡ đ¸đ° sk ¡ đ¸đŽ sl ¡ đˇđ¸ sr ¡ đ¸đŞ sv ¡ đ°đŞ sw ¡ đŽđł ta ¡ đŽđł te ¡ đšđ th ¡ đšđˇ tr ¡ đşđŚ uk-UA ¡ đľđ° ur ¡ đşđż uz ¡ đťđł vi ¡ đłđŹ yo ¡ đ¨đł zh-CN ¡ đšđź zh-TW
OmniRoute API-áᥠáŤáá ááááá áŞááááá á. ááá ááááŞááᥠáĄááŻáá á /v1 ááá˘áá á¤áááĄáĄá áá á§áááááá áŽá¨áá áá ááááá§áááááŁá ááá áááᥠáĄáááááá áŹáá á˘áááááĄ; áááááŹáŁá ááá áŹá§áá ááááá ááááĽáááŁá áá áŹáááááŽáááá docs/openapi.yaml áá src/app/api/-áᥠáĽááᨠáá áĄáááŁáá ááá á¨á áŁá˘áááᥠáŽá.
áĄáá áŠááá
- áŠáá˘áᥠáááĄá áŁáááááá
- ááĽáĄáááŁáááŁá á ááá ááŁáá áĄááĄááᥠááŻáá ááá
- áŠáá¨ááááááá
- áĄáŁá áááááᥠááááá áá ááá
- ááááŁáááá˘áᥠOCR
- ááááááááᥠáĄáá
- áá ááááááá áᥠááááááá˘áᥠááááá¤ááĄá˘á
- ááááĄáááááááᥠáĄáááááá áŹáá á˘ááááá
- á¤ááááááᥠAPI
- ááááá˘áŁá á ááááŁá¨áááááᥠAPI
- áŤááááᥠAPI
- WebSocket-áĄá˘á áááááá
- áááá˘ááááĄá áá áá ááááááááᥠááááá áá¨áááá
- áĄááááá˘áááŁá á ááá¨á
- ááá áááᥠáááááá áá ááá ááá
- ááááááááŞááááᥠááá ááá
- áááá°áŁáááá
- á ááááĄá˘á áá áááŁáá áááĄááŚááááá (ááá˘áááá˘áŁá á ááá ááá)
- ááááá˘áááᥠáá áá˘ááááá
- ááá áááᥠáá ááĽáĄá-áĄáá ááá ááá
- áááá ááááá (ááá¤áá áááááŁáá)
- áŁááá ááá
- áááŽáĄááá ááá
- MCP áĄáá ááá á
- A2A áĄáá ááá á
- áŚá áŁáááá, á¨áá¤ááĄááááá áá á¨ááááŹáááá
- ááááŽááááááᥠááááŁá¨ááááá
- áááááá˘áá¤ááááŞáá
áŠáá˘áᥠáááĄá áŁáááááá
POST /v1/chat/completions
Authorization: Bearer your-api-key
Content-Type: application/json
{
"model": "cc/claude-opus-4-6",
"messages": [
{"role": "user", "content": "Write a function to..."}
],
"stream": true
}
ááá ááááŁáá áĄááááŁá ááá
| áĄááááŁá á | ááááá ááŁáááá | ááŚáŹáá á |
|---|---|---|
X-OmniRoute-No-Cache |
ááááŽáááá | ááá¨áᥠáááá ááᥠááĄááááááá áááá§áááá true |
x-omniroute-no-memory |
ááááŽáááá | áá ááááŽáááááĄáááᥠáááŽáĄááá ááááĄá áá áŁááá áááᥠáŠááĄááᥠáááááĄáá˘ááááááá áááá§áááá true (no-cache-áᥠáááááááá; ááááááá ááááŞááááá ááááááŁáá áááááŤááŽáááᥠá˘ááááááááĄá áá áŚáá áááŁááááᥠáááááááá áŽáá áŻáááĄ) |
X-OmniRoute-Progress |
ááááŽáááá | áá ááá ááĄáᥠáááááááááᥠáááĄááŚáááá áááá§áááá true |
X-Session-Id |
ááááŽáááá | ááŁááááá áĄááĄááᥠáááĄááŚááá ááá á áĄááĄááŁá áááŻááááŁáááááĄááá ááááĄááááááááĄáááᥠ|
x_session_id |
ááááŽáááá | ááĄááá ááááŚááá áĽáááá á˘áá áááᥠááĽááá ááá áááá˘á (ááá ááááá á HTTP) |
X-OmniRoute-Session-Id |
ááááŽáááá | ááááááŤááŽááááᥠáááá áááŹáááááŁáá áĄááĄáááĄ/áĄááŁáá áᥠá˘ááá (ááĄááá ááááŹááááá áááŽáĄááá ááááĄ). áá áĄáááááᥠá¨ááááŽááááá¨á áŁáŞáááááá ááááŽááá call_logs.session_tag-á¨á, ááááááŁáá áĄááĄááᥠáŽáá áŻáááᥠáááĄáááŁáááááááá (#8249) â áá áá áĄáááááᥠá¨ááááŽááááá¨á áá ááĄáááᥠááááá áá áááá |
Idempotency-Key |
ááááŽáááá | ááŁáááááá˘áááᥠááŚááá¤áŽáá áᥠáááĄááŚááá (5-áŹáááááá á¤áááŻáá á) |
X-Request-Id |
ááááŽáááá | ááŁáááááá˘áááᥠááŚááá¤áŽáá áᥠááá˘áá ááá˘ááŁáá áááĄááŚááá |
X-OmniRoute-Cache |
áááĄáŁáŽá | HIT áá MISS (áĄá˘á ááááááᥠááá áá¨á) |
X-OmniRoute-Idempotent |
áááĄáŁáŽá | true, áᣠááŁáááááá˘á ááŚáááá¤áŽáá á |
X-OmniRoute-Progress |
áááĄáŁáŽá | enabled, áᣠáá ááá ááĄáᥠááááá§áŁá áᥠááááááá áŠáá ááŁááá |
X-OmniRoute-Session-Id |
áááĄáŁáŽá | OmniRoute-áᥠáááá ááááá§áááááŁáá áááĽáááá áĄááĄááᥠID |
X-OmniRoute-Request-Id |
áááĄáŁáŽá | ááááŽááááᥠááá ááááŞááᥠID (á ááááĄá᪠áŞááááááá) |
X-OmniRoute-Version |
áááĄáŁáŽá | OmniRoute-áᥠááááŹá§áááᥠááá áĄáá (á§áááááááᥠáŹáá áááááááááá) |
X-OmniRoute-Cost-Saved |
áááĄáŁáŽá | USD-á¨á áááááŽáá˘áŁáá ááááŽá, á ááááᥠáááŽáá áŻáá᪠ááá¨áá ááááááá áááŞááá HIT-áᥠáá áᥠ(ááŽáááá ááá¨á¨á áááŽáááá ááĄááĄ) |
X-OmniRoute-Decision |
áááĄáŁáŽá | ááá á¨á áŁá˘ááááŞááᥠááááá: strategy=<name>; provider=<alias>; latency_ms=<n> (<name> áá áᥠááááááááŞááᥠáĄá˘á áá˘áááá, áá single áá ááááááááá áááŁáá ááááŽáááááĄááááĄ) â áááĄá áŁááááᥠáááĄáŁáŽááá¨á á§áááááááᥠáŹáá áááááááááá |
á¨áááá¨ááá Nginx-áᥠá¨ááĄááŽáá: áᣠáĽáááá á˘áá áááᥠááĽááá áĄááááŁá ááᥠáá§ááááá (ááááááááá,
x_session_id), áŠáá áááunderscores_in_headers on;.
áŽáá áŻáááᥠá˘áááááá˘á ááᥠáĄááááŁá ááá: áŹáá ááá˘áááŁáá áá áááááááŁá á áááĄáŁáŽááá ááĄááá á¨áááŞááᥠáŽáá áŻáááᥠá˘áááááá˘á áááĄ
X-OmniRoute-*áááá ááᥠâX-OmniRoute-Response-Cost(USD, á¤ááĽáĄáá áááŁáá 10 áááŹááááá ááá¨ááá;0.0000000000áŁá¤ááĄá/á¨ááŁá¤ááĄááááá á¨ááááŽáááááááĄááááĄ),X-OmniRoute-Tokens-In/X-OmniRoute-Tokens-Out,X-OmniRoute-Model,X-OmniRoute-Provider,X-OmniRoute-Latency-Ms,X-OmniRoute-Cache-HitááX-OmniRoute-Fallback-Attempts(ááŽáááá ááá¨áá, á ááááĄá᪠> 0), ááĄáááX-OmniRoute-Request-IdááX-OmniRoute-Version. ááá ááá áŁááááá áŠáá˘áᥠáááĄá áŁáááááá,/v1/responses,/v1/messages, áá áááááᥠáĄáááááá áŹáá á˘ááááá â/v1/embeddings,/v1/images/generations,/v1/audio/speech,/v1/audio/transcriptions,/v1/rerank,/v1/videos/generations,/v1/music/generationsáá/v1/moderations(áŽáá áŻá á§ááááááááĄ0). áááááᥠáŽáá áŻá, á¤ááĄáᥠáŽáááááĄááŹáááááááᥠá¨ááááŽááááá¨á, ááááááááááá ááááááááᥠáááŽááááá (áááá áĄáŁá áááá, áŹáááá, áĄáááááááá áá áŤááááᥠáá áááŁááá), áŹáááááŚáááá á¨ááááŽááááá¨á áá áá ááĄ0(fail-open).
áĽáá¨á¨á áááááŽááááᥠáŽáá áŻáᥠáĄááááá˘ááá: áĄááááá˘áááŁá áĽáá¨á¨á áááááŽáááááĄáᥠ(
X-OmniRoute-Cache-Hit: true) áááá ááááᥠáĄáá áááĄááá áááááŤááŽááá áá áĄá áŁááááá, áááá˘ááX-OmniRoute-Response-Costáá ááĄ0.0000000000(áááááŽááááᥠááááĄááŽáŁá áááᥠáááá ááááá˘áŁáá áŽáá áŻá). áááááááá áááá/áĄáááá ááŁáá áŽáá áŻá áŞáááá áááĄááŽáááX-OmniRoute-Cost-Saved-á¨á. áááááááᥠááááŽááá ááááááá áŁááá á¨áááŻááááX-OmniRoute-Response-Cost(áĽáá¨á¨á áááááŽáááááá áá áá¤áá ᥠáŚáá áĄ); áĽáá¨áᥠáááááá˘ááááĄáááᥠá¨ááĄááŤáááááááX-OmniRoute-Cost-Saved-áᥠááá áááá ááá.
ááĽáĄáááŁáááŁá á ááá ááŁáá áĄááĄááᥠááŻáá ááá
ááĽáĄáááŁáááŁá á ááá ááŁáá áĄááĄááᥠááŻáá áá áááŞááá áá áᥠáá áŠááááá, áááááá˘ááĄááá áááááŁáááááááá ááá á¨á áŁá˘ááááŞááᥠáááá˘á ááĽá˘á: áá áá ááĽá˘ááŁá á áá¤áááááá á¤áááᥠáá á á¨ááĄáááááᥠOmniRoute áááá¨áá áĄ. áᥠáá áááĄáŞááᥠáááááᥠááŻáá áá, áá áááááŽááᥠOAuth-áĄ, áá ááŽáááᥠááááá áá˘áŁáá áááááá˘áᥠááááá˘áá¤ááŞáá áááᥠáá áá áááááŽááᥠááááá áá˘áŁá áá ááááááá áĄ.
áááááá˘áá¤ááááŞáááĄáááᥠááááá§áááááŁá API áááĄááŚááᥠáŁááá á°áĽááááᥠlease:exclusive áá á áá áŞáááĄááŽáá ááááááááŁáá, áá ááŞáá áááá allowedConnections áĄáá. áááááŞáááá ááááᥠááŁá˘ááŞááᥠáĄáááŚááá á áááĄááŚáááᥠá¨ááĽááááĄá áá áááŹááááá ááá áááááŽáááááááĄáᥠáá ááá áááᥠáá áááááááá ááááŹááááĄ.
POST /api/v1/session-leases
Authorization: Bearer <managed-api-key>
Content-Type: application/json
X-OmniRoute-Lease-Owner: vlo_<43-base64url-characters>
{"action":"acquire","model":"glm/glm-4.6"}
áŹáá ááá˘áááŁáá áááááááááĄ, áááááŽáááááĄá áá áááááááĄáŁá¤ááááᥠáááĄáŁáŽááá á¨áááŞááᥠáá ááᥠááá¨ááŁááááĄ, state-áĄá áá ááŁáĄá˘ ááááááá generation-áĄ, ááŁááŞá áá ááĄáááᥠá¨áááŞááᥠáá áŠááŁá áááá¨áá ᥠáá ááá˘áá ááááŞááᥠáááááŞáááááĄ. áááááŽáááááĄá áá áááááááĄáŁá¤áááááĄáᥠgeneration JSON-áᥠáĄáŽááŁáá¨á ááááááŞááá:
{ "action": "renew", "generation": 1 }
{ "action": "release", "generation": 1, "reason": "OWNER_EXIT" }
ááĽá˘ááŁá á ááŻáá áᥠáá¤áááááᥠá¨ááŁáŤááá áááááĄá áááááááá á ááááááĄáááᥠááá ááááá áááááŽáááᥠáááá¤áááááŞááááŁá áááᥠááŽá áá áŁáĄáá¤á ááŽá áĄááŠáááááááá ááá˘ááááááŞááááá:
{ "action": "status", "generation": 1 }
{
"state": "ACTIVE",
"generation": 1,
"acquiredAt": "2026-08-28T12:00:00.000Z",
"renewedAt": "2026-08-28T12:00:30.000Z",
"expiresAt": "2026-08-28T12:02:30.000Z",
"connection": {
"displayName": "Primary Codex",
"provider": "codex"
}
}
áᥠáá áŠááááá áĄá˘áá˘áŁáĄáᥠáááĽáááááá áá á áááááŞáááá ááááᥠá˘á áááááĽáŞááá¨á á¨ááááĄáááŚáá áŁááá áááŁááááá áááá áá¤ááááááá, áááááá˘áá¤ááŞáá áááŁáá ááá ááŁáá API áááĄááŚááááá áá ááŁáĄá˘á ááĽá˘ááŁá á generation-áá. displayName áá áᥠááŽáááá áááá¤áááŁá áá áááŁáá áááá¨áá áᥠáŠááááá ááá áĄááŽááá; áᣠáŁáĄáá¤á ááŽá áááá¤áááŁá áá áááŁáá áĄááŽááá áá áá áĄáááááĄ, áááĄá áááá¨áááááááá null. OmniRoute ááᥠáá ááĄáááᥠááááŞááááᥠááá¤ááĄá˘áᥠáááĄáááá ááá áá ááááá áá áááŁáá ááááá áá¨áᥠááááá˘áááá. áá ááááááá áᥠáááá¨ááááááá áá áᥠáá ááĄáááĄáá˘ááŁá á áĄááŠáááááááá ááá áá áá ááĄáááᥠáŹáá áááááááᥠááááá áá áááŁáá ááááĄááááá áá ááááááá áᥠááááá˘áá¤áááá˘áá áĄ. ááá˘áá ááááŞááᥠáááááŞááááá, á˘ááááááá, cookie-ááá, áááá¨áá áᥠáá API áááĄááŚáááᥠáááŁááŁá¨ááááááá id-ááá, áá¤ááááááᥠá°áá¨ááá, á¨ááááĄáááŚáá áᥠáĄááááŁáááááááá áá ááá á¨á áŁá˘ááááŞááᥠá¨ááá áááááŞááááá ááááá ááŞáŽáŁááá.
áá ááĄáŹáá á áááĄááŚáááá, áá ááĄáŹáá á áá¤ááááááá, áááŤááááááŁáá generation-áá á¨ááĄá áŁááááŁáá, áá áá áĄáááŁáá, áááááááĄáŁáá, áááááááĄáŁá¤ááááŁáá áá áááŁáĽááááŁáá áŤáááááá á§áááá ááá áŁáááᥠáá ááĄá áá ááááá 409 LEASE_FENCE_STALE á¨ááŞáááááĄ, áááá¨áá áᥠááá˘ááááááŞáááááᥠááá áá¨á. áááááá˘áĄ, á áááááá᪠áĄáááŤáááá áᥠááááááááᥠáááĄáŁáŽá ááááŚá, á¨ááĄááááŹáááááá ááĽá˘ááŁá á ááááá áá ááĽááĄ. á ááááĄá᪠ááá á¨á áŁá˘ááááŞáá ááĽá˘ááŁá ááŻáá áᥠáĄáŽáá ááááááá ááááá¨á áááááá§ááááĄ, ááááá generation áŤáááá¨á á áŠááá áá áĄá˘áá˘áŁáĄá áá˘áááŁá áá ááá áŁáááᥠááŽáá áááááᥠâ áá ááĄáááᥠáŤááááĄ. áá áĄáááŁáá áááááá˘ááá áŁáŞááááá á áŠááá, á ááááá áááááááááĄ, áááááŽáááááĄ, áááááááĄáŁá¤áááááĄá áá ááááááááᥠáááĄáŁáŽááá áááá áŠáŁáááᥠááááᥠáŹááá á¤áá ááááĄ.
áᥠáĄáá ááá áŁáá áááá˘á ááĽá˘á áá áŞáááᥠáĄá˘ááááá á˘áŁá OpenAI Codex /status-áĄ. áĄá˘ááááá á˘áŁáá Codex ááááááá ááŠáááááᥠááááááᥠáá ááááááá áĄá áá áŠáá¨áááááŁá áááááá˘áá¤ááááŞáááĄ/ááááá áá¨áᥠááááááá áááááĄ, ááŁááŞá áá ááĄááŽááᥠááá ááááŁáá áá ááááááá áᥠááááá áá¨áᥠáááááĄáááá ááá˘ááááááŞáááĄ; áĄáááááááá áááááá˘áᥠááá˘ááá ááŞááá áŁááá ááááááŤááŽáᥠáᥠáááĽáááááá áá áááááŹá§ááá˘ááĄ, á áááá ááŠááááᥠconnection.displayName.
áááᥠá¨ááááá, á§ááááá ááá ááŁáá ááá¤áá áááĄáᥠááááŽáááá áá ááá áĄááááá˘á ááá áĄááááŁá ᥠáááááĄáŞáááĄ:
X-OmniRoute-Lease-Owner: vlo_<43-base64url-characters>
X-OmniRoute-Lease-Generation: 1
ááŁáĄá˘á áá¤áááááá, generation, ááĽá˘ááŁá á áááá¨áá á áá áááááá˘áá¤ááŞáá áááŁáá API áááĄááŚááá ááááááŁáá ááŽáá ááááá ááá áááá ááááᥠáĄáá áááĄáá ááááá áááᥠááŞááááááᥠáŁá¨áŁáááá áŹáá á¨áááááĄáááŚáá ááá. áá¤áááááááĄá áá generation-áᥠáĄáŽáá áááĄááŚáááá áŽááááŽáá ááááá§ááááá áŹáá áŁááá˘áááááá ááá¨ááá᪠áá, á ááááĄá᪠áᥠáááĄááŚááá ááááá áááá¨áá ᥠáŁá¨ááááĄ. áááŁááŁá¨ááááááá áá¤áááááááá áá ááááŽááá ááŁáááááá, áá ááŚáá ááŞáŽááá ááŁá áááá¨á, áá á áŠááá ááááŽááááᥠáááááá˘áááŁá ááĄáá¨á áá áá ááááááááááááá áááá ááááᥠáĄáá áááĄáá.
áá áááááá áááááŁá áááŞáá ááá áŁáááᥠHTTP 429-ᥠRetry-After-áá áá á¨áááááá á¨ááááááĄáá:
{
"state": "WAITING_FOR_CAPACITY",
"error": { "type": "lease_error", "code": "LEASE_CAPACITY_UNAVAILABLE" },
"reason": "NO_FREE_ELIGIBLE_CONNECTION",
"retryAfter": 30
}
áᥠáááĄáŁáŽá ááŽáááá áááᥠááá¨ááááĄ, á áá áŠáááŁáááá ááá á¨ááĄááááááĄá áĄááá áááá áá áá§á áŞáá áááá áá á§ááááá áááááĄáŁá¤ááá áááááááá˘á áŁáŞáŽá ááĽá˘ááŁá ááŻáá áᥠááááá. ááŽáá áááŁááá ááá áááááááá/áá ááááááá ááá, ááááá˘áááᥠá¨ááŁáĄááááááá, ááá§ááááááᥠááá áááá, áááá˘á, áĄááŻáááĄááŚá áá á¨ááĄááááááĄáááᥠáĄáŽáá áŠáááŁáááá ááá áŹáá áŁááá˘áááááááá áááá áŠáŁáááᥠááááᥠáá áĄáááŁá OmniRoute áááĄáŁáŽáááĄ.
x-omniroute-compression
á¨áááŁáá¨ááᥠáááááᥠááááááŁáá ááááŽááááᥠáááááá áŠááááŞááááá. áŁáááŚáááĄá áá ááá áá˘áá˘á â áááááŹáááᥠááá á¨á áŁá˘ááááŞááᥠááááááááŞááᥠáŠááááŞááááááĄ, ááĽá˘ááŁá áá áá¤áááĄ, ááá˘áááá˘áŁá á˘á áááá áĄá áá ááááááᥠááááŁáááĄáŽááá áááá¨ááááááááĄ. áááá¨ááááááááá:
| áááá¨ááááááá | áá¤ááĽá˘á |
|---|---|
off |
áá ááááŽáááááĄáááᥠá¨áááŁáá¨áá áá áááááá§ááááá. |
default |
ááááááááá áááŚáááŁáá ááááŁáááĄáŽáááá áá áá¤ááá (ááĽá˘ááŁá áá áá¤ááᥠáŁááŁáááááá§áá¤áĄ). |
engine:<id> |
áá áá áŤá ááá, á ááááĄá᪠áᥠáŠáá ááŁááá, ááá. engine:rtk. |
<combo> |
áĄááŽááááááŁáá ááááááááŞáá; áááááŽáááá áŻáá áĄááŽáááá (á ááááĄá˘á áᥠáááŁááááááĄáŹááááááá), á¨ááááá áá id-áá áŽáááá. |
á¨áááá¨ááááá:
- áŁáŞáááá áááá¨ááááááááá ááááá áá áááá (ááááŽáááá áá ááĄáááᥠáŁáá á§áá¤ááá); ááááĄáááŚáá á ááááááᥠáááá áá˘áá áááᥠáŠáááŁáááá áá áá ááá áá˘áá˘áá.
- áᣠá áááááááá ááááááááŞááᥠáá áá áá ááááá áĄááŽááá ááĽááĄ, ááá˘áá áááááĄá˘áŁáá áááááŽáááááĄáááᥠááááááŞáá ááááááááŞááᥠid.
- ááááááááŞáá, á ááááᥠáĄááŽááá᪠áá ááĄ
offáádefault, áĄááŽáááá ááá á¨ááá áŠááá (áᥠáĄááááááŤá áĄáá˘á§áááá ááá ááááá ááááááá á˘ááá); ááĄáá ááááááááŞááᥠáááĄá id-áá ááááá ááá. - á¨áááŁáá¨ááᥠáááááá á áááááá ááááá ááááŞá á ááá ááá áá: á ááááĄá᪠á¨áááŁáá¨áá áááááááŁá áá ááááá ááŁááá, áᥠáĄááááŁá á ááᥠááá áŠáá ááááĄ.
ááááá§áááááŁáá ááááá áááĄáŁáŽáᥠáĄááááŁá á¨á áááĄááŽááá:
X-OmniRoute-Compression: <mode>; source=<source>
áĄááá᪠<source> áá áᥠáá á-áá áá á¨ááááááááá: request-header, routing-override, active-profile, auto-trigger, default áá off.
ááááááááááá
POST /v1/embeddings
Authorization: Bearer your-api-key
Content-Type: application/json
{
"model": "nebius/Qwen/Qwen3-Embedding-8B",
"input": "The food was delicious"
}
áŽáááááĄááŹááááá áá ááááááá ááá: Nebius, OpenAI, Mistral, Together AI, Fireworks, NVIDIA, OpenRouter, Jina AI.
ááá˘áááááᥠááááá˘áá¤áááá˘áá áááᥠá¤áá ááá˘áá provider/model (ááááááááá: jina-ai/jina-embeddings-v5-omni-small). á áááĄá˘á á¨á áá áĄáááŁáá Jina-ᥠááááááááᥠáŁáá áá¤ááĽáĄá ááááá˘áá¤áááá˘áá ááá᪠(ááááááááá, jina-embeddings-v5-text-small, jina-reranker-v3.5) ááŁá¨áááááá. Jina-ᥠembed/rerank/classify/segment áááá ááŞáááá áááááááá ááááá ááá áááᥠááááááᥠjina-ai ááá˘áá ááááŞááᥠáááááŞááááᥠáá§áááááĄ; JINA_AI_API_KEY ááŽáááá ááá¨áá áááááá§ááááá áĄáá áááá áá ááá áááá˘áá, á ááááĄá᪠ááá áááᥠáááááá¨á áááĄááŚááá áá áá áĄáááááĄ. jina-reader ááá ááá áááááŁááááááá ááŽáááá Reader-ááĄáááᥠ/ r.jina.ai-ááĄáááᥠ(POST /v1/web/fetch) áá áá ááĄáááᥠáŁáá áŁááááá§áá¤áĄ ááááááááááᥠáá áŽááááŽáá á ááááá ááááĄ.
á áááĄá˘á áᥠáááááááá, á áááááá᪠ááŁáá˘áááááááŁá ááŽáá ááááá áᥠááŞáŽáááááĄ, ááĄááá ááŚááᥠáá ááááááá ááĄááá áááááŁááááááá, áááĽáĄáááŁá 32 áĄá˘á áŁáĽá˘áŁá áá áááŁá ááááááá˘áĄ. ááááá-ááááááá˘áááᥠá˘áááááá text, image, audio, video áá document. áááá áááááᥠsource áá áᥠáá {"type":"url","url":"https://..."}, áá {"type":"base64","data":"...","media_type":"..."}.
Jina v5 Omni (jina-ai/jina-embeddings-v5-omni-small, jina-ai/jina-embeddings-v5-omni-nano áá ááŻááŽáᥠá¤áĄáááááááá jina-ai/jina-embeddings-v5-omni â omni-small) ááĄááá ááŚááᥠJina-ᥠáá¨áááááŁá EmbeddingsV5Request ááááŁáááá˘ááᥠáá áŁáŞáááááá ááááááááááᥠááá áááĄáááá ááá https://api.jina.ai/v1/embeddings:
{
"model": "jina-ai/jina-embeddings-v5-omni-small",
"task": "retrieval.query",
"normalized": true,
"input": [
{ "text": "a red bicycle" },
{ "image": "https://example.com/bike.png" },
{
"content": [{ "text": "caption" }, { "image": "data:image/png;base64,..." }]
}
]
}
áá¨áááááŁá á { image | audio | video | pdf } áááá¨ááááááááá á¨áááŤáááá áá§áᥠáĄááŻáá á HTTPS URL, data: URI áá áááŁááŁá¨ááááááá base64. OmniRoute áá áááááĽá˘ááᥠáĄá˘á ááĽáááááá áá ááá áááĽáááᥠáá áá¨áááááŁá á áĄáŁá áááááᥠURL-áááááá áááááŞááááᥠáá áŠáááá˘ááá áááᥠâ áĄááŻáá á áááááᥠááááá Jina ááŚáááĄ. Jina-ᥠááááá˘ááááá áááááá (task, normalized, truncate, embedding_type) ááááááááááááá. ááŽáááá á˘ááĽáĄá˘ááĄáááᥠáááááŁáááááá Jina SKU-ááá ááááá áŁáá á§áá¤áĄ áá áá˘ááĽáĄá˘áŁá ááááŁáááá˘áááĄ.
áŁáĄáá¤á ááŽáááááĄá áá á˘á áááĄááá á˘áá áááᥠá¨áááŚáŁááááá:
- áááĄá˘áááŞááŁá á áááááᥠURL-ááá áĄááŻáá á HTTPS áŁááá áá§ááĄ. ááááááááŁá á
{type,source:url}ááááááá˘ááá áĄáá ááá áᥠááŽáá áᥠáá˘ááá áááá (áááááááĄáááá ááááááᥠáŽááááŽááá áááááááŞááá, áá ááᥠááááá˘áá, ááááᥠá¨áááŚáŁáááááá, áĄááŻáá á DNS-ááá áá áááá¨áá áᥠá¤ááĽáĄáá áááá) áá áá ááááááá áᥠáááááŤááŽáááááá áŁá¨áŁáááá ááááŽááááá¨á ááááĄáááá. Jina-ᥠáá¨áááááŁá á{image:"https://..."}ááááááá˘ááá ááááá áĄááŻáá á HTTPS á¨ááááŹááááᥠá¨ááááá áŁáŞáááááá ááááááááááááá; URL-ᥠJina á˘ááá ááááĄ. - ááááŽááááá¨á áŠááĄááŁáá base64 ááááá á¨áááŚáŁááŁááá ááááááŁá ááááááá˘áá ááááááá áááŁáá 8 MiB-áá áá áááá ááááŽááááá¨á ááááááá áááŁáá 16 MiB-áá.
áá ááááááá ááĄáááᥠááá áááĽááá (ááááááááŁá á ááááááá˘ááá áá ááĄáááᥠááááááááááááá áŁáŞáááááá):
- Jina-ᥠááŁáá˘áááááááŁá á áááááááá: ááááááŁáá áááá ááááᥠááááááá˘á ááá ááááĽááááá ááááááááᥠáááĄááŚáááᥠááĽááá áá á áááááĽá˘áá (
text/image/audio/video/pdf), ááááŽááááá¨á áŠááĄááŁáá ááááááĄáááᥠdata URI-áááᥠááááá§áááááá; áááá áááĽá˘áá á á§áááá áááá ááááᥠááááááá˘áá. - Gemini Embedding 2-áᥠááŻááŽá: áááá ááááᥠáá áá áááĄááá ááá ááááĽááááá áá á áá¨áááááŁá
models/{model}:embedContentááááŽááááá,content.parts-áá (textááinline_data). - áŁáŞáááá/ááááááááŁá á áááááááá, á ááááááĄá᪠ááááááááᥠáŞáŽááá ááá˘ááááááŞááááá áá ááááŠááá, áĄá˘á áŁáĽá˘áŁá áá áááŁá á¨áá§ááááᥠHTTP 400-áá áŁáá á§áá¤áĄ.
{
"model": "jina-ai/jina-embeddings-v5-omni-small",
"input": [
{ "type": "text", "text": "A red bicycle" },
{
"type": "image",
"source": { "type": "url", "url": "https://example.com/bicycle.png" }
}
],
"dimensions": 512,
"encoding_format": "float"
}
áááááááĄá áá ááááááááᥠááŽáá áááŁááá ááá ááááááááŞáááá ááááááá˘áᥠááŤáŁááááá ááá áááĽáááᥠáááŞáááá HTTP 400-ᥠááá áŁááááĄ. áŤáááá áĄá˘á ááĽáááŁáá/á˘áááááŁá á ááááŽááááááᥠá¨áá§áááááĄááá áááŁáááá¨áá ááááá ááá¤áá áááááᥠáááááá ááááá áŁáŞáááááá ááááááŞááá.
# á§áááá áááááááááᥠááááááᥠáŠáááááááááá
GET /v1/embeddings
áĄáŁá áááááᥠááááá ááŞáá
POST /v1/images/generations
Authorization: Bearer your-api-key
Content-Type: application/json
{
"model": "openai/gpt-image-2",
"prompt": "A beautiful sunset over mountains",
"size": "1024x1024"
}
áŽáááááĄááŹááááá áá ááááááá ááá: OpenAI (GPT Image 2), xAI (Grok Image), Together AI (FLUX), Fireworks AI, Nebius (FLUX), Hyperbolic, NanoBanana, OpenRouter, SD WebUI (ááááááŁá á), ComfyUI (ááááááŁá á).
# áĄáŁá áááááᥠá§áááá ááááááᥠáŠáááááááááá
GET /v1/images/generations
ááááŁáááá˘áᥠOCR
POST /v1/ocr
Authorization: Bearer your-api-key
Content-Type: application/json
{
"model": "mistral/mistral-ocr-latest",
"document": {
"type": "document_url",
"document_url": "https://example.com/invoice.pdf"
}
}
model áá áŠááᥠOCR-áᥠáá ááááááá ᥠprovider/model áá áá¤ááĽáĄáᥠááá¨áááááá; ááŽáááá ááááááᥠid (ááá.
mistral-ocr-latest) ááᥠá ááááĄá˘á áá áááŁá áá ááááááá áá ááááááá ááá, áŽááá ááááá˘áááááŁáá model ááááŁáááĄáŽááááá
Mistral-ᥠ(mistral-ocr-latest) áá§áááááĄ. á ááááĄá˘á áá áááŁáá áá ááááááá ááá (open-sse/config/ocrRegistry.ts):
| áá ááááááá áᥠid | ááááááᥠid | model-áᥠáááá¨ááááááá |
á¨áááá¨ááááá |
|---|---|---|---|
mistral |
mistral-ocr-latest |
mistral/mistral-ocr-latest (áá ááŽáááá mistral-ocr-latest) |
áĄáááĽá áááŁáá â áááĄáŁáŽá ááá ááááá áá áŁááááá áá ááááá áá áááá ááááᥠáááááŤááŽáááááá. |
azure-document-intelligence |
prebuilt-read |
azure-document-intelligence/prebuilt-read |
ááĄáááĽá áááŁáá áááá áááá (analyze + ááááááááŽáá) â ááŽáááá áĽááááá. |
vertex-deepseek-ocr |
deepseek-ocr-maas |
vertex-deepseek-ocr/deepseek-ocr-maas |
áĄáááĽá áááŁáá, Vertex AI-áᥠopenapi/chat/completions ááá á˘áááá áŁáá áĄáááááá áŹáá á˘áááᥠááá¨áááááá â ááá˘áá ááááŞáááĄ/URL-ááĄáááᥠááŽáááá áĽááááá. |
áĄááááá áá ááááááá á áááĄáŁáŽááᥠMistral-áᥠáá ááááá á áĄá˘á áŁáĽá˘áŁá áᥠááĽááá áĄáŽááŁááá:
{
"pages": [{ "index": 0, "markdown": "# Extracted text..." }],
"model": "mistral-ocr-latest",
"usage_info": { "pages_processed": 1 }
}
Azure Document Intelligence-áᥠááááááááŽááᥠáááááá
Azure Document Intelligence-áᥠanalyze API ááĄáááĽá áááŁááá: áĄááŹá§ááĄá ááááŽáááá áĄáŽááŁááᥠáááŞáááá
Operation-Location áĄááááŁá ᥠááá áŁáááᥠáá á¨áááááᥠáááĄááŚáááá ááá ááááŁáá ááááááááŽááá áĄáááá á. áááááŁá¨ááááááá
(open-sse/handlers/ocr.ts) áá URL-ᥠá§áááá áŹááá¨á áá ááŽáá, áááĽáĄáááŁá 30 ááŞááááááᥠááááááááááá¨á ááááááááŽáááĄ, áááŁá§áááááááá áŹá§áááá (áá
ááá áŤááááᥠááááááááŽáááĄ) áá á-ok ááááááááŽááᥠáááĄáŁáŽáᥠáá "failed" áĄá˘áá˘áŁáĄáᥠá¨ááááŽááááá¨á áá ááá áŁáááᥠ504-áĄ, ááŁ
ááŞááááááááᥠááááá˘áᥠááááŹáŁá ááᥠá¨ááááá áááá ááŞáá áŻáá ááááá áááááááá ááááĄ. Azure-áᥠáĄáááááá áááĄáŁáŽá áááá áŁááááááá
ááá ááááááááá Mistral-áᥠáááá ááááá§áááááŁá ááááá pages/markdown áĄá˘á áŁáĽá˘áŁá áá¨á, áááá˘áá áááááá˘áᥠááááĄ
áá ááááááá ááĄáááᥠáĄáááŞááááŁá á ááááŁá¨ááááá áá áĄááá áááá.
Vertex AI DeepSeek OCR-áᥠááá˘áá ááááŞáá áá áĄáááááá áŹáá á˘áááᥠááááĄáááŚáá á
vertex-deepseek-ocr áŽááááŽáá áá§ááááᥠVertex AI-áᥠááá˘áá ááááŞááᥠááááá áááĽááááááĄ, á áááááĄá᪠OmniRoute áŁááá áŁááá ᥠááŽáá áĄ
áŠáá˘ááĄ/áĄáŁá áááááᥠá˘á áá¤ááááĄáááᥠ(open-sse/executors/vertex.ts): áááá¨áá áᥠAPI áááĄááŚááá áá áᥠáá
Service Account JSON-áᥠááá˘áá ááááŞááᥠáááááŞááááá (á áááááá᪠JWT-bearer
ááááááᥠááá¨áááááá ááŞááááá áŽááááááá OAuth áŹáááááᥠá˘áááááá), áá áŁááá á¨ááĽááááá OAuth áŹáááááᥠá˘ááááá, á ááááá᪠áŁáŞáááááá áááááá§ááááá. áááá ááááᥠáĄáááááá áŹáá á˘áááᥠURL áá áᥠVertex-ááĄ
áááááá openapi/chat/completions ááá á˘áááá áŁáá áĄáááááá áŹáá á˘ááá, á ááááá᪠áááá¨áá áᥠáá áááĽá˘ááĄá áá
á ááááááᥠáĄáá¤áŁáŤááááá áááááá â áŞáŽáááá ááááááááŁá providerSpecificData.project/providerSpecificData.region-ᥠá§áááááááᥠááááááá áŁááá áá˘ááĄááá;
áŹáááááŚáááá á¨ááááŽááááá¨á áá áááĽá˘á ááááŚááá Service Account JSON-áᥠproject_id-ááá, áŽááá á áááááááĄ
ááááŁáááĄáŽáááá áááá¨áááááááá us-central1. áá ááá ááááĄáááŚáá á áŽáááá open-sse/handlers/ocr.ts-á¨á
(resolveVertexOcrAccessToken, resolveVertexOcrBaseUrl) áá áááááá§ááááá
src/app/api/v1/ocr/route.ts-áᥠáááá handleOcr-áá áááááááĄáááá ááááááá.
ááááááááᥠáĄáá
GET /v1/models
Authorization: Bearer your-api-key
â ááá áŁáááᥠáŠáá˘ááĄ, embedding-ááĄá áá áĄáŁá áááááᥠá§áááá áááááᥠ+ ááááááááŞáááᥠOpenAI-áᥠá¤áá ááá˘á¨á
ááááááᥠid-áᥠáá áá¤ááĽáĄááá (?prefix=)
ááááááááᥠáŁááá˘ááĄááá áŹáá áááááááááá áá ááááááá áᥠáá áá¤ááĽáĄáá. áááŚáááŁá áá áá¤ááĽáĄáĄ ááááá˘á áááááĄ
MODELS_CATALOG_PREFIX_MODE á¤áŁááĽáŞááŁá á ááááá áá áááĄá áŠááááŞááááá á¨ááĄááŤááááááá ááááááŁáá ááááŽáááááĄááááĄ
query-ááá áááá˘á áá â áᥠáĄááĄáá áááááá áááááá˘ááĄááááĄ, á áááááĄá᪠áĄáŁá¤áá áĄáá áĄáŁá ᥠáĄáá ááá áᥠáĄááá áá
ááá áááá˘á áᥠá§áááá ááááá áŠááááĄáááᥠá¨ááŞáááᥠááá áá¨á:
GET /v1/models?prefix=alias # áááá id áááá ááááááá â ááááá alias-áá áá¤ááĽáĄá
GET /v1/models?prefix=dual # áá ááá á¤áá áá (áĄáá ááá áᥠááááŁáááĄáŽáááá ááá áááá˘á á)
GET /v1/models?prefix=canonical # ááŽáááá áĄá áŁáá provider-id áá áá¤ááĽáĄá
| á ááááá | ááá áŁáááᥠ| á¨áááá¨ááááá |
|---|---|---|
dual |
cc/claude-sonnet-4-6 áá claude/claude-sonnet-4-6 |
ááááŁáááĄáŽáááá. áá ááá id áá ááĄá áá ááááá ááááááá ááá á¨á áŁá˘áááá; á¨áááá áŠáŁááááŁááá, á ááá áááŁá¨ááᥠáááááá˘áááᥠáááá¤áááŁá ááŞááááá, á áááááá¨á᪠á ááááááá á¤áá ááá ááá ááááá áááŹáá ááá. ááá˘áááááᥠááááᥠááááŽáááááá ááá ááááááĄ. |
alias |
cc/claude-sonnet-4-6 |
áááá áŠááááŹáá á áááá ááááááá. ááááĄáŽááááááŁáá alias-áᥠáá ááĽááá áá ááááááá ááá᪠áááá᪠ááá áŁááááá ááááááá áŠááááŹáá áĄ, áááá˘áá áá áá¤áá á áááá áááá. |
canonical |
claude/claude-sonnet-4-6 |
áááá áŠááááŹáá á áááá ááááááá, áĄá áŁáá provider-id áá áá¤ááĽáĄáá. ááááĄáŽááááááŁáá alias-áᥠáá ááĽááá áá ááááááá ááá᪠(ááá., antigravity/âŚ, agy/âŚ) ááĽá᪠ááá áŁááááá ááááááá áá ááááá á id-áĄ, áááá˘áá áá áá¤áá á áááá áááá. |
dual á áááááᥠáĄáá áááĄááá á áŠááááŹáá áᥠááááŞáááá query-ááá áááá˘á áᥠááá áá¨á᪠á¨áááŤáááá: ááᥠááĽáᥠparent
áááá, á ááááá᪠áŤáá áááá id-áá áááŁááááááĄ.
áááááá˘áááá, á áááááá᪠ááááááᥠááĄáá áŠáá ááá˘áá á¤áááĄáĄ ááŠááááááá, áŁááá áááááŽáááá ?prefix=alias â áĄáŹáá áá ááĄá ááĽáŞááá
OmniCopilot VS Code ááá¤áá ááááá.
ááááááááᥠno-thinking ááá áááá˘ááá
ááá ááááááᥠáŁááá áᥠááĽááá Claude áááááááááĄáááᥠ/v1/models ááĄááá áŹáá áááááááᥠno-thinking ááá áááá˘áĄ, á ááááᥠid-ᥠááĽáᥠáá áá¤ááĽáĄá claude-3-omniroute-no-thinking/:
claude-3-omniroute-no-thinking/<provider>/<model>
áá id-áᥠáá áŠááááĄáᥠ(ááá., Claude Code-áᥠáááá¤áááŁá ááŞááá¨á, á ááááá᪠á§áááááááᥠáŁá áááᥠthinking áááááĄ), áᥠááááá á ááááŁá <provider>/<model>-áá ááá ááááĽááááá, ááŁááŞá ááĄáŻááááá áŠááŽá¨áááááá â /v1/messages ááá á¨á áŁá˘áá áááááá§ááááá thinking:{type:"disabled"}, áŽááá /v1/chat/completions ááá á¨á áŁá˘áá reasoning/reasoning_effort áááááá áááááá˘ááááá. ááá áááá˘á áŠáááááááááá¨á á¨áááᥠááŽáááá Claude-áᥠááŻááŽáᥠáá áááááááááĄááááĄ, á ááááááĄá᪠ááĽáá ááá ááááááᥠááŽáá ááááá á áá áááááááĄáŹáááááá disabled-ᥠ(áááá˘áá, ááááááááá, adaptive-only áááááááá, á áááááá᪠disabled-ᥠáŁáá á§áá¤áá, ááááá ááŞáŽáŁááá). áááá áá˘áá ááᥠá¨ááŁáŤáááá ááááááŁáá áááááááĄáááᥠáá ááá áááá˘áᥠááŤáŁááááá áŠáá ááá áá ááááá ááá ModelSpec.noThinkingAlias-áᥠááá¨áááááá.
áá ááááááá áᥠáááááááᥠááááá¤ááĄá˘á
GET /api/v1/provider-plugin-manifest
ááá áŁáááᥠJSON-ááá ááááĄáááá áá ááááááá áᥠáááááááᥠááááá¤ááĄá˘áĄ, á áááááĄá᪠áá§áááááá Bifrost, CLIProxyAPI áá áĄáááááááá sidecar-á ááŁá˘áá ááá. áááĄáŁáŽá ááááá áá áááá TypeScript-áᥠáá ááááááá áá á áááĄá˘á áááá áá ááááá áᎠáá á¨áááŞááᥠOAuth áááááá˘áᥠáĄááááŁááááááááĄ, á¨ááĄá áŁááááᥠááá áááᥠááááĄáááŚáá ááĄ, executor á¤áŁááĽáŞááááĄ, ááááŽááááᥠáĄááááŁá áááĄá áá ááááá áá¨áᥠáááááŞáááááĄ.
áááááá§áááá áᥠendpoint, á ááááĄá᪠sidecar áá ááŞááĄáᥠááá áá ááŁá¨áááᥠáá
open-sse/config/providerPluginManifestRegistry.ts-áᥠááá ááááá ááááá á˘áĄ ááá ááŽáá áŽáááĄ.
ááááĄáááááááᥠendpoint-ááá
| áááááá | ááá | á¤áá ááá˘á |
|---|---|---|
| POST | /v1/chat/completions |
OpenAI |
| POST | /v1/messages |
Anthropic |
| POST | /v1/responses |
OpenAI Responses |
| POST | /v1/embeddings |
OpenAI |
| POST | /v1/images/generations |
OpenAI Images |
| POST | /v1/images/edits |
OpenAI Images (á ááááĽá˘áá ááá/inpaint) |
| POST | /v1/videos/generations |
OpenAI-áᥠáĄá˘áááᥠáááááᥠááááá ááŞáá |
| POST | /v1/music/generations |
OpenAI-áᥠáĄá˘áááᥠááŁáĄáááᥠááááá ááŞáá |
| POST | /v1/audio/transcriptions |
OpenAI Audio (STT) |
| POST | /v1/audio/speech |
OpenAI TTS (ááá áŁáááᥠááŁáááᥠáĄáŽááŁááĄ) |
| POST | /v1/rerank |
Cohere/Voyage-áᥠáĄá˘áááᥠrerank |
| POST | /v1/classify |
Jina classify (api.jina.ai) |
| POST | /v1/segment |
Jina segmenter (segment.jina.ai) |
| POST | /v1/moderations |
OpenAI Moderations |
| GET | /v1/models |
OpenAI |
| POST | /v1/messages/count_tokens |
Anthropic |
| GET | /v1beta/models |
Gemini |
| POST | /v1beta/models/{...path} |
Gemini generateContent |
| POST | /v1/api/chat |
Ollama |
| GET | /api/v1/vscode/{token}/ |
OpenAI ááá˘áááááᥠalias |
| GET | /api/v1/vscode/{token}/models |
OpenAI ááááááááᥠalias |
| POST | /api/v1/vscode/{token}/chat/completions |
OpenAI-áᥠá˘áááááááááŁáá alias |
| POST | /api/v1/vscode/{token}/responses |
OpenAI Responses-áᥠá˘áááááááááŁáá alias |
| POST | /api/v1/vscode/{token}/api/chat |
Ollama-ᥠá˘áááááááááŁáá alias |
| GET | /api/v1/vscode/{token}/api/tags |
Ollama tags-áᥠá˘áááááááááŁáá alias |
á§áááá POST ááá á¨á áŁá˘á áá ááĄá áá ááááá áĄá˘á áŁáĽá˘áŁá áᥠáá§áááááĄ: Bearer your-api-key + Zod-áá ááááááá áááŁáá JSON áĄáŽááŁáá (v1RerankSchema, v1ModerationSchema, v1AudioSpeechSchema áá á.á¨.; ááŽáááá src/shared/validation/schemas.ts). áĄáĽáááᥠáááááááŞááᥠáŹáá áŁááá˘áááááááĄáᥠáá áŁááááá 4xx.
áááááá˘ááááĄááááĄ, á ááááááĄá᪠áá á¨ááŁáŤáááá Authorization: Bearer ...-áᥠááááá˘ááá, OmniRoute ááĄááá ááŚááᥠAPI áááĄááŚááááᥠURL-á¨á â áá query-string ááááĄáááááááᥠááá¨áááááá (?token=..., ?apiKey=..., ?api_key=..., ?key=...), áá áĽááááá ááááŁáááá˘áá áááŁáá áĄáááŞááááŁá á /api/v1/vscode/{token}/... endpoint-áááᥠáĄáá¨áŁáááááá.
# Rerank
POST /v1/rerank { "model": "jina-ai/jina-reranker-v3.5", "query": "...", "documents": ["..."] }
# Jina classify (Foundation API-áᥠááá˘áá ááááŞááᥠáááááŞááááá)
POST /v1/classify { "model": "jina-embeddings-v5-text-small", "input": ["..."], "labels": ["a", "b"] }
# Jina segmenter
POST /v1/segment { "content": "...", "return_chunks": true }
# Jina search (s.jina.ai; áá ááááááá áᥠalias-ááá: jina-search, jina-ai, jina)
POST /v1/search { "query": "...", "provider": "jina-search" }
# Moderations
POST /v1/moderations { "model": "omni-moderation-latest", "input": "..." }
# TTS â ááá áŁáááᥠaudio/mpeg (áá ááááŽááááá á¤áá ááá˘áĄ) áĄáŽááŁááĄ
POST /v1/audio/speech { "model": "openai/tts-1", "input": "Hello", "voice": "alloy" }
# áĄáŁá áááᥠá ááááĽá˘áá ááá (multipart)
POST /v1/images/edits -F image=@input.png -F prompt="..." -F mask=@mask.png
# áááááᥠ/ ááŁáĄáááᥠááááá ááŞáá (áá ááááááá áᥠáá áá¤ááĽáĄáááá ááááááᥠID)
POST /v1/videos/generations { "model": "runway/gen-3", "prompt": "..." }
POST /v1/music/generations { "model": "suno/v3.5", "prompt": "..." }
áá ááááááá áᥠáĄáááŞááááŁá á ááá á¨á áŁá˘ááá
POST /v1/providers/{provider}/chat/completions
POST /v1/providers/{provider}/embeddings
POST /v1/providers/{provider}/images/generations
áá ááááááá áᥠáá áá¤ááĽáĄá ááá˘áááá˘áŁá áá áááá˘ááá, áᣠááááááááŁáá áá áá ááĄ. á¨ááŁáĄááááá áááááááá ááá áŁááááá 400-áĄ.
Files API
OpenAI-ááá ááááĄááááá á¤ááááááᥠendpoint-á ááááá˘áŁá á á¨áá§áááááĄ/ááááá˘ááááĄá áá ááááá¨ááŁááááᥠáááŽááááá á¤ááááááᥠáá˘ááá ááááĄááááĄ.
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| POST | /v1/files |
á¤ááááᥠáá˘ááá ááá (multipart: file, purpose, expires_after[anchor], expires_after[seconds]) â áááĽáĄáááŁá 512 MiB |
| GET | /v1/files |
áááááá˘áá¤ááŞáá áááŁá API áááĄááŚááááá áááááá¨áá áááŁáá á¤ááááááᥠáĄááᥠáááŚááá |
| GET | /v1/files/[id] |
á¤ááááᥠááá˘ááááááŞáááááᥠáááŚááá |
| DELETE | /v1/files/[id] |
á¤ááááᥠáŹáá¨áá |
| GET | /v1/files/[id]/content |
á¤ááááᥠáááŁááŁá¨ááááááá á¨ááááááĄáᥠááááááᥠáĄááŽáá áááá áŁáááá |
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá â á¤áááááá ááááááŁáá API áááĄááŚáááᥠáááŽááááá áááááá áááŁááá getApiKeyRequestScope-áᥠááá¨áááááá.
Batches API
OpenAI-ááá ááááĄááááá ááááá˘áŁá á ááááŁá¨ááááá.
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| POST | /v1/batches |
ááááá˘áᥠá¨ááĽááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá v1BatchCreateSchema-áá (input_file_id, endpoint, completion_window) |
| GET | /v1/batches |
ááááá˘áááᥠáĄááᥠáááŚááá |
| GET | /v1/batches/[id] |
ááááá˘áᥠáĄá˘áá˘áŁáĄááĄá áá request_counts-áᥠáááŚááá |
| DELETE | /v1/batches/[id] |
áááĄá áŁááááŁáá/áŹáá áŁááá˘ááááá ááááá˘áᥠáŹáá¨áá |
| POST | /v1/batches/[id]/cancel |
áááááááá á ááááá˘áᥠáááŁáĽáááá |
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá. ááááá˘ááá ááááááŁáá API áááĄááŚáááᥠáááŽááááá áááááá áááŁááá.
Search API
ááá/áŤááááᥠááááŹááááááááᥠáááĄá˘á ááĽáŞáá (Tavily, Brave, Exa, Serper áá áĄáŽá.).
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /v1/search |
áááá¤áááŁá áá áááŁáá áŤááááᥠááááŹáááááááááĄá áá áááá á¨ááĄááŤáááááááááᥠáĄááᥠáááŚááá |
| POST | /v1/search |
áĄááŤáááá ááááŽááááᥠááá¨áááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá v1SearchSchema-áá; ááŽáá ááááá áááá áĽáá¨áá ááá/áááá ááááááá |
| GET | /v1/search/analytics |
ááááááŁáá ááááŹáááááááĄáááᥠáááááŽáááááááĄ/ááá§áááááááĄ/áĽáá¨áᥠáĄá˘áá˘ááĄá˘ááá |
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá (extractApiKey + isValidApiKey). áŤááááᥠááááá˘ááá ááŚáĄá áŁááááá enforceApiKeyPolicy-áᥠááá¨áááááá.
Web Fetch API
áááá¤áááŁá áá áááŁáá web-fetch áá ááááááá áᥠááá¨áááááá URL-ááá áááá˘ááá˘áᥠááááŚááá (Firecrawl, Jina Reader, Tavily Extract, TinyFish Fetch, Nimble Extract).
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| POST | /v1/web/fetch |
URL-áᥠáááŚááá/áĄáá áááááá â body áááŹááááá v1WebFetchSchema-áá |
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá (extractApiKey + isValidApiKey). ááááá˘ááá ááŚáĄá áŁááááá enforceApiKeyPolicy-áᥠááá¨áááááá.
áááá˘áᥠááááááááĄáŹáááááá áĄáá áááá áá áááĽáááááá (#8297): á ááááĄá᪠provider áŞáááĄááŽáá áá áá áᥠááááááááŁáá, ááŁáá
(firecrawl â jina-reader â tavily-search â tinyfish â nimble-search)
á¤ááĽáĄáá áááŁáá áá ááá áá˘áá˘áŁáá áááááááááá áááá (fill-first) ááŁá¨áááááá â áĄááŽá¨áá áá á¨áááŚáŁááŁáá, áááá áá áááá¤áááŁá áá áááŁáá áá ááááááá á ááááá˘áááááŁááá
ááááŽááááᥠááááá áááá á¨ááŹá§ááá˘áᥠáááŞáááá, áŽááá áŽááááŽáá áĄááŞáááá/áááá˘ááĄááá áááááá¨áá áááŁáá upstream á¨ááŞáááááĄááĄ
(HTTP 429 á§ááááááááĄ; 402/403 â Firecrawl/Tavily/TinyFish-áᥠáááá˘áᥠá˘áááᥠáŁá¤ááĄá ááááááááĄáááᥠâ
áá á Jina Reader-ááĄáááᥠáá áá ááĄáá áᥠáŠáááŁáááá ááá 400 áá ááĄáŹáá á ááááŽáááááĄááááĄ) ááááŽááááᥠá¨ááĄá áŁááááᥠáá áᥠáĄááĄá˘ááá áááááááĄ
á¨ááááá áŻáá áááááŁáŞááá áá ááááááá áá, á ááááᥠááá˘áá ááááŞááᥠáááááŞááááá᪠áŽáááááĄááŹáááááá. á ááááĄá᪠ááŁáá¨á áá áĄáááŁáá á§áááá áá ááááááá ááĄ
á¨ááĄááŤááááááá ááááŹáŁá áŁááá, endpoint áŹááá áááááá 400-áᥠáááŞáááá ááá áŁáááᥠáá áááá 429-ᥠ(Retry-After
header-áá). á ááááĄá᪠áŞáááĄááŽáá áááááŽááááá ááááá áá˘áŁáá provider, á¤áá áŁáá áĄáá áááá áá ááááá ááá áá áŽáááá â áĄááŽá¨áá áá á¨áááŚáŁááŁáá áá áááŁááá áááá áŞáááĄááŽáá ááááááááŁáá
áá ááááááá á áĄáááŁááá á¨ááŞááááᥠááá áŁáááᥠ(áĄááŽá¨áá áá á¨áááŚáŁááááĄáᥠ429, áĄáŽáá á¨ááááŽááááá¨á áá upstream
áĄá˘áá˘áŁáĄáĄ).
WebSocket áĄá˘á áááááá
GET /v1/ws?handshake=1
ááááŹáááᥠWebSocket upgrade handshake-ᥠáá ááá áŁáááᥠwire protocol-áᥠá¨áá˘á§áááááááááᥠáááááááááᥠ(request, cancel). á ááááŁá WS frame-ááᥠáááŁá¨ááááᥠáŠáá¨áááááŁáá WS áĄáá ááá á, Next.js-áᥠroute-áááᥠáŞáŽá áááᥠááá áá.
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá handshake-áᥠáá ááĄ.
Responses API WebSocket-áᥠááá¨áááááá (ááŽáááá codex)
# ááááá host:port, á á᪠HTTP API-ᥠááĽáᥠ(ááááŁáááĄáŽááááá 20128); ááááááŽááá áááá¨áá á:
wscat -c "ws://localhost:20128/v1/responses?api_key=<OMNIROUTE_API_KEY>"
# (áá: -H "Authorization: Bearer <OMNIROUTE_API_KEY>")
# ááá áááá frame ááŁáŞááááááá response.create áŁááá áá§ááĄ:
{ "type": "response.create", "model": "gpt-5.5", "input": [ { "role": "user", "content": "hi" } ] }
Responses-API-over-WebSocket áá ááĽáĄá ááĽáĄáááŁáááŁá áá codex-ááá áá áᥠáááááá¨áá áááŁáá (ChatGPT
backend). áᥠAPI/dashboard-áᥠááááá ááá á˘áá áŁáĄáááᥠáááĄáááá áááᥠ/v1/responses,
/responses áá /api/v1/responses. ááá ááá response.create frame-áá ááĄ
á¨ááá codex-responses-ws bridge-áᥠááá¨áááááá ááŽáá áŞáááááᥠáááááá˘áá¤ááááŞáááĄá áá ááááááááááĄ, áá áŠáááĄ
codex OAuth áááá¨áá ᥠáá wreq-js transport-áᥠááá¨áááááá áĽáááᥠáááá ááᥠwss://chatgpt.com/backend-api/codex/responses-ááá.
áá á-codex áááááááá áŁáá á§áá¤áááá (codex_ws_provider_required).
áááá˘áᥠáááááá áááᥠááá á¨á áŁá˘ááááŞáááĄáááᥠáááááá§áááá model: "qtSd/<group>/codex/<model>". ááááááááá˘áá áááŁááá
app/server-ws.mjs + scripts/dev/responses-ws-proxy.mjs + src/app/api/internal/codex-responses-ws/route.ts-á¨á.
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá handshake-áᥠáá ááĄ. áŠáá¨áááááŁáá HTTP áĄáá ááá á (server-ws.mjs)
ááĽá˘ááŁá á entrypoint áŁááá áá§áᥠ(áá ááááŁáááĄáŽááááá ááĄááŞáá, á ááááĄá᪠app/server-ws.mjs áá áĄáááááĄ).
ááááááᥠid: áááááá§áááá ChatGPT-áᥠáŁá¨áŁááá id (codex/ áá áá¤ááĽáĄáᥠááá áá¨á)
OpenAI Codex CLI ááááááᥠáĄááŽááᥠáááááá˘áᥠááŽáá áᥠááááŹááááĄ, á ááááĄááŞ
supports_websockets = true, áá áŁáá á§áá¤áĄ áá ááááááá áᥠáá áá¤ááĽáĄááá id-áááĄ, á áááá ááŞáá
codex/gpt-5.5 (The 'codex/gpt-5.5' model is not supported when using Codex with a ChatGPT account). ááááááááá áŁá¨áŁááá id (ááá. gpt-5.5). OmniRoute-áᥠbridge
ááŽáááá codex-ááĄááááĄáá áááááŁáááááá, áááá˘áá upstream áááá áááᥠá¨ááĽáááááá áᥠáŁá¨áŁááá id-ᥠáŽááááŽáá ááááĄáááŚáá áááĄ, á áááá ᪠codex ááááááĄ
(resolveCodexWsModelInfo) â áááŁáŽáááááá ááááĄá, á áá áŁá¨áŁááá
gpt-5.5 HTTP-áᥠááá¨áááááá áĄáŽáá áá ááááááá ááá ááááááááááááááá.
OpenAI Codex CLI-áᥠáááá¤áááŁá ááŞáá
áááŁááááá Codex CLI-ᥠOmniRoute-áá, ~/.codex/config.toml-á¨á WebSocket-ááĄ
ááŽáá ááááá áᥠááĽááá ááá ááááŁáá áá ááááááá áᥠááááá˘áááá (áá áĄáááŁáá áááá¤áááŁá ááŞááᥠáŽááá¨ááŁáŽááááá áááĄáá˘ááááááá áááááá§áááá áŞáááá CODEX_HOME):
model = "gpt-5.5" # áŁá¨áŁááá id â áá á "codex/gpt-5.5"
model_provider = "omniroute"
[model_providers.omniroute]
name = "OmniRoute (WS)"
base_url = "http://localhost:20128/v1" # ááááá¨á áááŽá ááá áŽááá áá áŁááá áá§ááĄ; WS URL áááĄááá áŹáá ááááĽááááá (production-á¨á áááááá§áááá https/wss)
wire_api = "responses" # áá ááááá áá ááŽáá ááááá ááá áááá¨ááááááá 2026 áŹááᥠááááá áááááá
supports_websockets = true # áááĽá˘ááŁá ááᥠResponses-over-WS transport-áĄ
env_key = "OMNIROUTE_API_KEY" # á¨áááŞááᥠOmniRoute API áááĄááŚááᥠ(Bearer)
export OMNIROUTE_API_KEY=sk-... # OmniRoute API áááĄááŚááá (áááááĄáááá á áááĄááŚááá, áᣠREQUIRE_API_KEY=false)
codex exec "Responda apenas: PONG"
CLI base_url + /responses-ᥠWebSocket-ááá áááŽááááĄ, áŽááá OmniRoute áááĄ
á¨áá áŠááŁá codex OAuth áááá¨áá ááá áááá áááá ááááá¨áá áááĄ. áĄá áŁááá á¨ááááŹááááŁááá ááááááŁá
áĄáá ááá áá: ChatGPT ááá áŁáááᥠcodex.rate_limits + response.created-ᥠáá completion-ᥠááááááá áááááĄáŞáááĄ.
áááá˘ááá áá áá ááááááááᥠá¨áá˘á§ááááááá
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /v1/quotas/check |
á ááááĄá˘á áá áááŁáá áááĄááŚáááᥠáááŞáááááá provider + accountId-ááĄáááᥠáááá˘áᥠáŹááááĄáŹáá á áááááááŞáá |
| POST | /v1/issues/report |
áááá˘ááĄ/áááĄááŚáááᥠáááŞáááᥠá¨ááŞááááᥠGitHub-áá á¨áá˘á§ááááááá (áĄáááá áááᥠGITHUB_ISSUES_REPO + á˘áááááĄ) |
áááááá˘áá¤ááááŞáá: Bearer API-áááĄááŚááá (isAuthenticated).
ááááááááĄááŽáŁá áááᥠááááá§ááááá (/api/usage/om-usage)
áááááĄáááá API-áááĄááŚááᥠá¨ááŁáŤááá áááŽáᥠáĄáááŁááá á ááááá§ááááá áá áááá˘ááá â ááá áááᥠáááááá˘áá¤ááááŞáá áĄáááá á áá áá ááĄ. áá áĄáááááá áŹáá á˘ááᥠáááááá˘á (CLI, OmniCopilot-áᥠáááááá) áá§áááááĄ, á ááá áááĄááŚáááᥠáá¤áááááᥠááŠááááᥠáááĄá áááááŽáá áŻá.
# á˘ááĽáĄá˘áŁá á á¤áá áá (ááĄá˘áá ááŁáá áááá˘á ááĽá˘á â áŁáá ááá á˘ááĽáĄá˘á á˘áá áááááááĄááááĄ)
curl -H "Authorization: Bearer <your-api-key>" \
http://localhost:20128/api/usage/om-usage
# áĄá˘á áŁáĽá˘áŁá áá áááŁáá á¤áá áá â á áááááĄá᪠UI ááááŽááá áĄ
curl -H "Authorization: Bearer <your-api-key>" \
"http://localhost:20128/api/usage/om-usage?format=json"
áááĄááŚááááĄáááᥠallowUsageCommand áŠáá ááŁáá áŁááá áá§áᥠ(ááááŁáááĄáŽááááá ááááá ááŁááá â ááá áááᥠááááááᥠAPI-áááĄááŚáááááᥠáááááŻáá á ááᥠááááááŁáá áááĄááŚááááĄáááᥠáŞáá-áŞáááá á áááᥠáá ááá¨áááĄ). ááᥠááá áá¨á áĄáááááá áŹáá á˘ááá áááĄáŁáŽááᥠ403-áá.
?format=json ááá áŁáááᥠááááááĄáŽáááááááá ááá¨ááá áĄá˘á áŁáĽá˘áŁá áá áááŁá á¤áá áááĄ, á ááá ááááááŤááŽáááááá áŁáá á§áá¤áᥠáááĄáŁáŽáááá áááááŞáááá áááá áá ááĄáá áᥠáŹááááááŽááĄ. áŹáá ááá˘áááᥠá¨ááááŽááááá¨á:
{
"allowed": true,
// áŹáá áááááááááá ááŽáááá ááá¨áá, á ááááĄá᪠áááĄááŚááááĄáááᥠáŠáá ááŁááá ááááááááŁáááŁá á ááááá§áááááᥠááááá˘ááá (ááŚááŁá á/áááá ááŁáá USD):
"personal": {
"dailySpentUsd": 1.25,
"dailyLimitUsd": 5,
"dailyResetAtIso": "âŚ",
"weeklySpentUsd": 8,
"weeklyLimitUsd": 20,
"weeklyResetAtIso": "âŚ" /* ⌠*/,
},
// áá áŠááŁáá áá ááááááá áᥠáááá˘áᥠáá§ááĄááá á áĄáŁá ááá, áá null, á ááááĄá᪠áĽáá¨á¨á áŻáá áá áá¤áá áá:
"provider": {
"connectionId": "âŚ",
"provider": "claude",
"plan": "âŚ",
"quotas": {/* ⌠*/},
},
// á§áááá áááá¨áá áᥠáá§ááĄááá á áĄáŁá ááá, á ááá UI-á á áááááááá áá ááááááá á áá áááááááᥠáááá ááá áááááĄááŽááĄ:
"providers": [
{ "connectionId": "âŚ", "provider": "claude" /* ⌠*/ },
{ "provider": "codex" /* ⌠*/ },
],
}
áŁáá á§áá¤áᥠá¨ááááŽááááá¨á (401 áá ááĄáŹáá á áááĄááŚááá / 403 ááááá ááá áá áá ááĄ) ááááá ááá á¨á áŁá˘á ááá áŁááááĄ
{ "allowed": false, "error": { "message": "âŚ" } }-ᥠâ áá áĄáááŁáá, áááá áá áŞáá áááá personal/provider
(áááĄááŚááá ááá¨ááááŁááá, ááŁááŞá áŻáá áá áá¤áá áá áááŚáááŁáá) áŁáá á§áá¤ááĄááá ááááĄáŽááááááŁáá ááááááá ááááá áá ááá ááŽáááá JSON-á¤áá áá áááááĄáŽááááááĄ.
áááááá˘áá¤ááááŞáá: ááááááŤááŽááááᥠáĄáááŁááá á Bearer API-áááĄááŚááá, á ááááá᪠áááŹááááá isValidApiKey-áá â áᥠáá áá ááĄ
ááá áááᥠááá˘áá á¤áááĄá (/api/keys/âŚ), á ááááá᪠ááááá requireManagementAuth-áá áá áᥠáááŞáŁáá.
áĄááááá˘áááŁá á áĽáá¨á
# áĽáá¨áᥠáĄá˘áá˘ááĄá˘áááᥠáááŚááá
GET /api/cache/stats
# á§áááá áĽáá¨áᥠáááĄáŁá¤áááááá
DELETE /api/cache/stats
áááĄáŁáŽáᥠáááááááá:
{
"semanticCache": {
"memorySize": 42,
"memoryMaxSize": 500,
"dbSize": 128,
"hitRate": 0.65
},
"idempotency": {
"activeKeys": 3,
"windowMs": 5000
}
}
ááááááá ááá§áááááááá
áĄááááá˘áááŁá á áĽáá¨áᥠHIT áááĄáŁáŽáĄ áĽáá¨áááá áááá ááááᥠáĄáá áááĄáᥠáááááŤááŽáááᥠááá áá¨á
ááŹááááĄ, áááá˘áá áááŠáááááá X-OmniRoute-Response-Latency ááááĽááᥠááŁááᥠá˘áááá
(áááá ááááᥠáĄáá áááĄáᥠáááááááá áááá ááá§ááááááᥠáááŁáŽáááááá). ááá§áááááááĄáááá ááá áŤáááááá á áááááá˘áááá
(áĄááá áááá˘ááŞáá áŹáá ááááááᥠá˘ááĄá˘áá ááá, p50/p99 ááááá˘áá áááá) áŁááá á¨áááááŹááá
áááĄáŁáŽáᥠáĄááááŁá á X-OmniRoute-Cache-Latency:
| áááá¨ááááááá | áááááá á˘ááá |
|---|---|
synthetic |
áááĄáŁáŽá áááŹáááááŁááá áĽáá¨áááá; ááá§áááááá áááá ááááᥠáĄáá áááĄáᥠá ááááŁá á áá á áá áá áᥠ|
| (áá áá ááĄ) | áááĄáŁáŽá áááŚáááŁááá áááá ááááᥠáĄáá áááĄáᥠá ááááŁá á áááááŤááŽáááá |
áĽáá¨áᥠáááá ááᥠáááá ááááááŁáá áááĄááŚááááĄááááĄ
API-áááĄááŚááááᥠá¨ááŁáŤáááá áŁáá á ááĽááá áĄááááá˘áááŁá á áĽáá¨áááá áŹáááááŽáááá cacheDefaultMode-áᥠááá¨áááááá:
| áááá¨ááááááá | áĽáŞááá |
|---|---|
legacy |
áĽáá¨áᥠáŠáááŁáááá ááá áĽáŞááá (ááááŁáááĄáŽáááá) |
bypass |
áĽáá¨á¨á áŤááááᥠáĄá áŁááá ááááá˘ááááá; á§áááááááᥠáááá ááááᥠáĄáá áááĄáᥠáááááŤááŽááá |
áááá§áááá áááĄááŚáááᥠá¨ááĽááááĄáᥠ(POST /api/keys) áá áááááŽáááááĄáᥠ(PATCH /api/keys/[id]):
{ "cacheDefaultMode": "bypass" }
áĽáá¨áᥠáááá ááᥠáááá ááááááŁáá ááááŽáááááĄááááĄ
áááááĄáááá ááááŽááááᥠá¨ááŁáŤááá áááĄááŚáááᥠááá áááá˘á áááᥠáááŁáŽáááááá áááá áá ááŁáá áᥠáĽáá¨áĄ:
X-OmniRoute-No-Cache: true
áĄáááá¤áá áááŞáá áááááá áá ááá ááá
ááá áááᥠááá á¨á áŁá˘ááá (/api/*, áĄááŻáá á áááááá˘áá¤ááááŞáááĄ/á¨ááĄáááᥠááá áá) áŠáááŁáááá ááá ááá¤áá áááĄáᥠAPI áááĄááŚáááááá áá ááá˘áá áááááá. ááá˘áá ááááŞááᥠáááááŞáááááᥠááŻááŽááá, áŹáááááᥠáĄá¤áá áááá áá curl-áᥠáááááááááá:
ááá áááᥠáááááá˘áá¤ááááŞáá.
áááááá˘áá¤ááááŞáá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/auth/login |
POST | á¨ááĄááá |
/api/auth/logout |
POST | áááááĄááá |
/api/settings/require-login |
GET/PUT | á¨ááĄáááᥠááááŽááááᥠááááá ááá |
áá ááááááá áááᥠááá ááá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/providers |
GET/POST | áá ááááááá áááᥠáŠáááááááááá / á¨ááĽááá |
/api/providers/[id] |
GET/PUT/DELETE | áá ááááááá áᥠááá ááá |
/api/providers/[id]/test |
POST | áá ááááááá ááá áááá¨áá áᥠá¨ááááŹáááá |
/api/providers/[id]/models |
GET | áá ááááááá áᥠááááááááᥠáŠáááááááááá |
/api/providers/validate |
POST | áá ááááááá áᥠáááá¤áááŁá ááŞááᥠáááááááŞáá |
/api/providers/bulk |
POST | áá áá áá ááááááá ááĄáááᥠAPI áááĄááŚáááááᥠáááĄááá áááá ááááá˘ááá |
/api/providers/import |
POST | á°áá˘áá áááááŁáá áá ááááááá áááᥠáĄááᥠááááá á˘á ááááŁá¨áááááŁáá CSV/JSON á¤ááááááá (#6836); áááŹááááá ááá á¨ááŞááááááᥠá¨ááááááá ááááááŁáá ááŹáá ááááĄáááᥠ|
/api/provider-nodes* |
áĄáŽáááááĄáŽáá | áá ááááááá áᥠáááááŤáááᥠááá ááá |
/api/provider-models |
GET/POST/PATCH/DELETE | ááá ááááŁáá áááááááá (ááááá˘ááá, áááááŽáááá, ááááááá/áŠáááááá, áŹáá¨áá) |
OAuth áá ááŞááĄááá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/oauth/[provider]/[action] |
áĄáŽáááááĄáŽáá | áá ááááááá ááĄáááᥠáĄáááŞáá¤áááŁá á OAuth |
ááá á¨á áŁá˘ááááŞáá áá áááá¤áááŁá ááŞáá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/models/alias |
GET/POST | ááááááááᥠá¤áĄáááááááááá |
/api/models/catalog |
GET | á§áááá áááááá áá ááááááá ááĄá áá á˘áááᥠáááŽááááá |
/api/combos* |
áĄáŽáááááĄáŽáá | ááááááááŞááááᥠááá ááá |
/api/keys* |
áĄáŽáááááĄáŽáá | API áááĄááŚáááááᥠááá ááá |
/api/pricing |
GET | ááááááááᥠá¤ááĄááá |
ááááá§ááááá áá áááááá˘ááá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/usage/history |
GET | ááááá§áááááᥠááĄá˘áá áá |
/api/usage/logs |
GET | ááááá§áááááᥠááŁá áááááá |
/api/usage/request-logs |
GET | ááááŽááááᥠááááᥠááŁá áááááá |
/api/usage/[connectionId] |
GET | ááááá§ááááá ááááááŁáá áááá¨áá ááĄáááᥠ|
/api/usage/token-limits |
GET/POST/DELETE | á˘áááááááᥠááááá˘áᥠáááŁáŻáá˘ááá ááááááŁáá API áááĄááŚááááĄáááᥠ|
/api/usage/model-latency-stats |
GET | áááŤá ááá ááá§ááááááᥠááá áááá˘á ááááááŁáá áá ááááááá ááĄá áá áááááááĄáááᥠ(áĄáá¨áŁááá/p50/p95/p99, áŹáá ááá˘áááᥠáááŠáááááááá); á¤ááá˘á ááá: windowHours/minSamples/maxRows/provider/model (#6873) |
/api/usage/cache-health |
GET | call_logs-áá ááá¤áŁáŤááááŁáá ááááŽááááᥠáĽáá¨áᥠááááááá ááááᥠá¨ááŻááááá â áŠááŹáá á/áŹáááááŽááᥠááááá¤áá áááá, áŠááŹáá áᥠááááᥠp50/p90/p99 áááááŹááááá, áááá áááŞáŁááááᥠáŠááŹáá áááᥠááááŞááá˘á ááŞáá, ááá§áá¤á ááááááááᥠáááŽááááá áá healthy/degraded/thrash/no-data á¨áá¤ááĄááá; ááááŽááááᥠááá áááá˘á ááá: range (1h|24h|7d|30d, ááááŁáááĄáŽááááá 24h) áá áá ááĄááááááááŁáá model (#8827) |
ááá áááá˘á ááá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/settings |
GET/PUT/PATCH | áááááá ááá áááá˘á ááá |
/api/settings/proxy |
GET/PUT | áĽáĄáááŁá á áá ááĽáĄáᥠáááá¤áááŁá ááŞáá |
/api/settings/proxy/test |
POST | áá ááĽáĄá-áááá¨áá áᥠá¨ááááŹáááá |
/api/settings/ip-filter |
GET/PUT | IP áááĄáááá ááááᥠááááááá ááŁáá/ááááááááá áĄáá |
/api/settings/thinking-budget |
GET/PUT | ááá áááááááĄ/ááĄáŻáááááᥠááááŽááááᥠáááááŹáá áᥠá ááááá (áŁáŞáááááá áááááŞááá / ááá˘áááá˘áŁá á áááŞááááá / ááá ááááŁáá / ááááá˘ááŁá á). á¨áááŁáá¨áááĄááá áááááŁááááááááá. ááŽáááá THINKING_BUDGET.md. |
/api/settings/system-prompt |
GET/PUT | áááááááŁá á áĄááĄá˘áááŁá á áá áááá˘á |
/api/settings/compression |
GET/PUT | áááááááŁá á á¨áááŁáá¨ááᥠáááá¤áááŁá ááŞáá |
/api/settings/purge-request-history |
POST | ááááŽááááááᥠááŁá ááááᥠáŠááááŹáá ááááĄá áá ááááááŁá á áááááŤááŽáááááᥠááŁá ááááᥠáá á˘áá¤ááĽá˘áááᥠáááĄáŁá¤áááááá |
áááá˘ááĽáĄá˘á áá á¨áááŁáá¨áá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/compression/preview |
POST | off/lite/standard/aggressive/ultra/RTK/stacked á¨áááŁáá¨ááᥠáŹááááĄáŹáá á áááŽáá |
/api/compression/language-packs |
GET | áŽáááááĄááŹááááá Caveman áááᥠááááá˘áááᥠáĄáá |
/api/compression/rules |
GET | Caveman-áᥠáŹááĄáááᥠááá˘ááááááŞáááááᥠáĄáá |
/api/context/caveman/config |
GET/PUT | Caveman-áᥠáĄáááŞáá¤áááŁá á ááá áááá˘á áááᥠá¤áĄáááááááá |
/api/context/rtk/config |
GET/PUT | RTK-áᥠáĄáááŞáá¤áááŁá á ááá áááá˘á ááá, ááá á¨áá áᥠááá ááááŁáá á¤ááá˘á ááá áá áááŁááŁá¨ááááááá áááááááááá áááááŞáááááᥠá¨ááááŽáá |
/api/context/rtk/filters |
GET | RTK-áᥠá¤ááá˘á áááᥠááá˘ááááá áá ááá ááááŁáá á¤ááá˘á áááᥠáááááááĄá˘ááá |
/api/context/rtk/test |
POST | RTK-áᥠáŹááááĄáŹáá á áááŽáááĄ/á˘ááĄá˘áᥠááá¨áááá á˘ááĽáĄá˘áŁá áááááŞáááááá |
/api/context/rtk/raw-output/[id] |
GET | áááŠáááááááᥠid-áᥠáááŽááááá á¨ááááŽáŁáá, á ááááĽá˘áá áááŁáá áááŁááŁá¨ááááááá áááááááááá áááááŞáááááᥠáŹáááááŽáá |
/api/context/combos |
GET/POST | á¨áááŁáá¨ááᥠááááááááŞááááᥠáĄáá/á¨ááĽááá |
/api/context/combos/[id] |
GET/PUT/DELETE | á¨áááŁáá¨ááᥠááááááááŞááᥠááá˘ááááá/áááááŽáááá/áŹáá¨áá |
/api/context/combos/[id]/assignments |
GET/PUT | á¨áááŁáá¨ááᥠááááááááŞááááᥠááá á¨á áŁá˘ááááŞááᥠááááááááŞááááá áááááááá |
/api/context/analytics |
GET | á¨áááŁáá¨ááᥠáááááá˘áááᥠá¤áĄáááááááá |
ááááá˘áá áááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/sessions |
GET | ááĽá˘ááŁá á áĄááĄááááᥠááááá§áŁá áᥠááááááá |
/api/rate-limits |
GET | ááááááŁáá ááááá áá¨áᥠááááŽáááááá áĄááŽá¨áá áᥠááááá˘ááá |
/api/monitoring/health |
GET | áĄááŻáááĄááŚáᥠá¨ááááŹáááá + áá ááááááá áááᥠá¨ááŻááááá (catalogCount, configuredCount, activeCount, monitoredCount). ááá áááᥠáŽááá á¨áááŞááᥠcredentialHealth-áĄ: á¨ááááŹááááᥠáĽáá¨áᥠáĄááááá áŁá áááá¨áááááááááĄ, failedConnections-áĄ, á ááááĄá᪠failed>0, áá staleDbNonOkCount-ᥠ(SQLite-áᥠááŁááááá test_status, áá áá á áááŠáááááááá). ááŽáááá MONITORING_GUIDE.md. |
/api/cache/stats |
GET/DELETE | áĽáá¨áᥠáĄá˘áá˘ááĄá˘ááá / áááĄáŁá¤áááááá |
/api/modality-bridge/stats |
GET | áááŽáĄááá áááá¨á áá áĄáááŁáá attempts, áŹáá ááá˘áááŁáá ááŞáááááááá/bridged, áŹáá áŁááá˘ááááá ááŞáááááááá, áĽáá¨áᥠáááááŽáááááá, totalLatencyMs, latencySamples, ááááŁá¨áááᥠá áááááááááá ááá¤áŁáŤááááŁáá averageLatencyMs áá áááá ááááá§áááááᥠáá á (ááŁááááá áŽááááŽáá ááá¨áááááĄááĄ; ááá áááᥠááá˘áá ááááŞáá) |
/api/modality-bridge/video/runtime |
GET | ááááŞá á áĄáááá loopback-á¨ááááŹáááá ááá áááᥠááá˘áá ááááŞááááá/á¨ááááŹááááááá; FFmpeg/ffprobe-áᥠáŽáááááĄááŹááááááááĄá áá ááá áĄááááᥠáááĄáŁá¤ááááááŁáá áááááŞááááá (á¨ááááŽááᥠááá áá¨á) |
/api/modality-bridge/video/extract |
POST | á¨ááá, ááá˘áá áááááŁáá, áĄáááá loopback áááá˘áááᥠáá áááá á; 50 MiB á¨ááááááá áááááŞááááá, á¨áááŚáŁááŁáá á ááá/32 MiB áááááááááá áááááŞááááá, 503 áĄáááŤáááá áᥠááááŹáŁá áááĄááĄ, 499 áááá¨áá áᥠáááŹá§ááá˘ááĄááĄ, 504 ááááᥠááááŹáŁá áááĄááĄ; áá áŹáá áááááááᥠáĄááŻáá á áá˘ááá áááᥠAPI-ᥠ|
áĄáá áááá áá ááĄáá áá ááĽáĄááá á˘á/ááááá á˘á
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/db-backups |
GET | áŽáááááĄááŹááááá áĄáá áááá áá ááĄááááᥠáŠáááááááááá |
/api/db-backups |
PUT | áĄáá áááá áá ááĄááᥠáŽáááá á¨ááĽááá |
/api/db-backups |
POST | ááááá áá˘áŁáá áĄáá áááá áá ááĄááááá ááŚááááá |
/api/db-backups/export |
GET | áááááŞáááá ááááᥠ.sqlite á¤ááááá áŠáááá˘ááá ááá |
/api/db-backups/import |
POST | áááááŞáááá ááááᥠáŠááĄááááŞááááááá .sqlite á¤ááááᥠáá˘ááá ááá |
/api/db-backups/exportAll |
GET | áĄá áŁáá áĄáá áááá áá ááĄááᥠ.tar.gz áá áĽáááá áŠáááá˘ááá ááá |
áŚá áŁááááááá áĄáááĽá ááááááŞáá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/sync/cloud |
áĄáŽáááááĄáŽáá | áŚá áŁááááááá áĄáááĽá ááááááŞááᥠáááá ááŞáááá |
/api/sync/initialize |
POST | áĄáááĽá ááááááŞááᥠááááŞáááááááŞáá |
/api/cloud/* |
áĄáŽáááááĄáŽáá | áŚá áŁáááᥠááá ááá |
áááá ááááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/tunnels/cloudflared |
GET | áĄáááá¤áá áááŞáá ááá¤ááĄáááᥠCloudflare Quick Tunnel-áᥠáááĄá˘ááááŞáááĄ/ááá¨ááááᥠáĄá˘áá˘áŁáĄáᥠáŹáááááŽáá |
/api/tunnels/cloudflared |
POST | Cloudflare Quick Tunnel-áᥠáŠáá ááá áá ááááá ááá (action=enable/disable) |
/api/tunnels/ngrok |
GET | áĄáááá¤áá áááŞáá ááá¤ááĄáááᥠngrok Tunnel-áᥠááá¨ááááᥠáĄá˘áá˘áŁáĄáᥠáŹáááááŽáá |
/api/tunnels/ngrok |
POST | ngrok Tunnel-áᥠáŠáá ááá áá ááááá ááá (action=enable/disable) |
CLI áŽáááĄááŹá§áááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/cli-tools/claude-settings |
GET | Claude CLI-áᥠáĄá˘áá˘áŁáĄá |
/api/cli-tools/codex-settings |
GET | Codex CLI-áᥠáĄá˘áá˘áŁáĄá |
/api/cli-tools/droid-settings |
GET | Droid CLI-áᥠáĄá˘áá˘áŁáĄá |
/api/cli-tools/openclaw-settings |
GET | OpenClaw CLI-áᥠáĄá˘áá˘áŁáĄá |
/api/cli-tools/runtime/[toolId] |
GET | áááááá CLI-áᥠááá¨ááááᥠááá ááá |
CLI-áᥠáááĄáŁáŽááá á¨áááŞáááĄ: installed, runnable, command, commandPath, runtimeMode, reason.
ACP ááááá˘ááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/acp/agents |
GET | á§áááá ááŚáááŠááááá ááááá˘áᥠ(áŠáá¨áááááŁáá + ááá ááááŁáá) áĄá˘áá˘áŁáĄáá áŠáááááááááá |
/api/acp/agents |
POST | ááá ááááŁáá ááááá˘áᥠááááá˘ááá áá ááŚáááŠáááᥠááá¨áᥠáááááŽáááá |
/api/acp/agents |
DELETE | ááá ááááŁáá ááááá˘áᥠáŹáá¨áá id ááááŽááááᥠááá áááá˘á áᥠáááŽááááá |
GET áááĄáŁáŽá á¨áááŞááᥠagents[]-ᥠ(id, name, binary, version, installed, protocol, isCustom) áá summary-ᥠ(total, installed, notFound, builtIn, custom).
áááá ááááá áá áĄááŽá¨áá áᥠááááá˘ááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/resilience |
GET/PATCH | ááááŽááááááᥠá ááááĄ, áááá¨áá áᥠááá§áááááááĄ, áá ááááááá áᥠááááá ááááááĄá áá ááááááᥠááá áááá˘á áááᥠáááŚááá/áááááŽáááá |
/api/resilience/reset |
POST | áá ááááááá áᥠáŹá áááᥠááááá áááááááᥠáĄááŹá§áᥠááááááá ááááá¨á áááá áŁáááá |
/api/resilience/model-cooldowns |
GET | ááĽá˘ááŁá á (áá ááááááá á, áááá¨áá á, áááááá) áááááá áááááᥠáŠáááááááááá, ááá áŠááááá áá ááᥠáááŽááááá ááááááááŁáá |
/api/resilience/model-cooldowns |
DELETE | ááááááᥠáááááá áááᥠáááŁáĽáááá â á§ááááá¤áá á áááĄááĄáŁá¤áááááááá áĄáŽááŁáá {provider, model} áá {all: true} |
/api/rate-limits |
GET | ááááááŁáá ááááá áá¨áᥠáĄááŽá¨áá áᥠááááá˘áᥠáĄá˘áá˘áŁáĄá |
/api/rate-limit |
GET | áĄááŽá¨áá áᥠááááá˘áᥠáááááááŁá á áááá¤áááŁá ááŞáá |
áááŽááá
/api/resilience/*ááá á¨á áŁá˘á áĄáááá áááᥠááá áááᥠááá˘áá ááááŞááᥠ(requireManagementAuth). áá ááááááá áᥠááááá áááááĄ, áááá¨áá áᥠááá§áááááááĄá áá ááááááᥠáááááá áááᥠá¨áá áᥠááááĄáŽááááááááᥠáĄá áŁáá áááááŽáááááĄáááᥠááŽáááá áááá ááááá (ááá¤áá áááááŁáá).
á¨áá¤ááĄááááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/evals |
GET/POST | á¨áá¤ááĄáááᥠáááááááĽá˘áááᥠáŠáááááááááá / á¨áá¤ááĄáááᥠááá¨áááá |
ááááá˘ááááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/policies |
GET/POST/DELETE | ááá á¨á áŁá˘ááááŞááᥠááááá˘áááááᥠááá ááá |
á¨ááĄááááááĄááá
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/api/compliance/audit-log |
GET | á¨ááĄááááááĄáááᥠááŁááá˘áᥠááŁá áááá (áááá N) |
v1beta (Gemini-áĄááá ááááĄááááá)
| Endpoint | áááááá | ááŚáŹáá á |
|---|---|---|
/v1beta/models |
GET | ááááááááᥠáŠáááááááááá Gemini-áᥠá¤áá ááá˘á¨á |
/v1beta/models/{...path} |
POST | Gemini-áᥠgenerateContent endpoint |
áᥠendpoint-ááá ááááá ááᥠGemini-áᥠAPI á¤áá ááá˘áĄ áá áááááá˘ááááĄááááĄ, á áááááá᪠Gemini-áᥠáá¨áááááŁá SDK-áĄááá ááááĄáááááááᥠááááááá.
á¨ááá / áĄááĄá˘áááŁá á API-ááá
| áĄáááááá áŹáá á˘ááá | áááááá | ááŚáŹáá á |
|---|---|---|
/api/init |
GET | áááááááŞááᥠááááŞáááááááŞááᥠá¨ááááŹáááá (áááááá§ááááá ááá áááá ááá¨áááááĄááĄ) |
/api/tags |
GET | Ollama-áĄááá ááááĄááááá ááááááᥠá˘ááááá (Ollama-ᥠáááááá˘ááááĄááááĄ) |
/api/restart |
POST | áĄáá ááá áᥠááá ááĽá˘áŁáá ááááá˘ááá áááᥠááááŞááá ááá |
/api/shutdown |
POST | áĄáá ááá áᥠááá ááĽá˘áŁáá ááááá áááᥠááááŞááá ááá |
/api/system/env/repair |
POST | OAuth áá ááááááá áᥠááá áááᥠáŞáááááááᥠááŚááááá |
á¨áááá¨ááá: áᥠáĄáááááá áŹáá á˘ááááá áááááá§ááááá áĄááĄá˘áááᥠá¨ááá ááááááááĄáááᥠáá Ollama-ᥠáááááá˘ááááá ááááĄááááááááĄááááĄ. áŠáááŁáááá áá, áĄáááááá ááááŽááá áááááá ááá ááá ááááá áá ááŤááŽáááá.
OAuth ááá áááᥠááŚááááá (v3.6.1+)
POST /api/system/env/repair
Content-Type: application/json
{
"provider": "claude-code"
}
ááŚáááááᥠááááá áá˘áŁáá áá ááááááá áᥠááááá ááŁá áá áááááááááŁá OAuth ááá áááᥠáŞáááááááĄ. ááá áŁááááĄ:
{
"success": true,
"repaired": ["CLAUDE_CODE_OAUTH_CLIENT_ID", "CLAUDE_CODE_OAUTH_CLIENT_SECRET"],
"backupPath": "/home/user/.omniroute/backups/env-repair-2026-04-11.bak"
}
ááŁáááᥠá˘á áááĄáá áá¤áŞáá
POST /v1/audio/transcriptions
Authorization: Bearer your-api-key
Content-Type: multipart/form-data
ááŁáááá¤ááááááᥠá˘á áááĄáá áá¤áŞáá áááááĄáááá á áááá¤áááŁá áá áááŁáá STT áá ááááááá áᥠááááá§áááááá. ááááááᥠááá áááá
áĄáááááá˘á áá áŠááᥠááá˘ááŁá áá ááááááá ᥠ(openai/âŚ, deepgram/âŚ). ááá ááááááá, á áááááááŞ
áĄáŽáá ááááŹááááááᥠáááááᥠáŽááááŽáá ááĽáĄááá á˘áá áááá, áá§áááááá áááááá¤ááŞáá áááŁá ááááá˘áá¤áááá˘áá áĄ
(openrouter/deepgram/nova-3).
ááááŽáááá:
curl -X POST http://localhost:20128/v1/audio/transcriptions \
-H "Authorization: Bearer your-api-key" \
-F "file=@recording.mp3" \
-F "model=openai/whisper-1"
áááĄáŁáŽá:
{
"text": "Hello, this is the transcribed audio content.",
"task": "transcribe",
"language": "en",
"duration": 12.5
}
ááááááᥠááááá˘áá¤áááá˘áá áááᥠáááááááááá: openai/whisper-1 (áĄáááá áááᥠOpenAI-áᥠáááĄááŚáááĄ),
openrouter/deepgram/nova-3 (áĄáááá áááᥠOpenRouter-áᥠáááĄááŚáááĄ),
deepgram/nova-3 (áĄáááá áááᥠááá˘ááŁá Deepgram-áᥠáááĄááŚáááĄ). áá ááááááá¤ááŞáá áááŁáá
deepgram/nova-3 ááááŽáááá OpenRouter-ᥠáá áá§áááááĄ.
ááŽáá ááááá ááá á¤áá ááá˘ááá: mp3, wav, m4a, flac, ogg, webm.
Ollama-áĄááá ááááĄááááááá
áááááá˘ááááĄááááĄ, á áááááá᪠Ollama-ᥠAPI á¤áá ááá˘áĄ áá§áááááá:
# áŠáá˘áᥠáĄáááááá áŹáá á˘ááá (Ollama-ᥠá¤áá ááá˘á)
POST /v1/api/chat
# ááááááááᥠáŠáááááááááá (Ollama-ᥠá¤áá ááá˘á)
GET /api/tags
ááááŽáááááá ááá˘áááá˘áŁá áá ááá ááááĽááááá Ollama-áĄá áá á¨ááá á¤áá ááá˘ááᥠá¨áá ááĄ.
á˘áááááááááŁáá VS Code / áĄááááŁá áᥠááá áá¨á á¤áĄáááááááááá
áááááá§áááá áᥠá¤áĄáááááááááá, á ááááĄá᪠ááá˘ááá ááŞááᥠáá á¨ááŁáŤááá Authorization áĄááááŁá áᥠáŠááĄáá áá API áááĄááŚááá áĄááááááĄá URL-á¨á áŁááá áá§áᥠáŠáá¨áááááŁáá.
# OpenAI-áᥠáĄá˘áááᥠááá˘áááááᥠá¤áĄáááááááá
GET /api/v1/vscode/{token}/
GET /api/v1/vscode/{token}/models
# OpenAI-áᥠáĄá˘áááᥠáŠáá˘áᥠá¤áĄáááááááááá
POST /api/v1/vscode/{token}/chat/completions
POST /api/v1/vscode/{token}/responses
# Ollama-ᥠáĄá˘áááᥠá¤áĄáááááááááá
POST /api/v1/vscode/{token}/api/chat
GET /api/v1/vscode/{token}/api/tags
áááááááá:
curl https://your-host.example/api/v1/vscode/YOUR_API_KEY/models
curl -X POST https://your-host.example/api/v1/vscode/YOUR_API_KEY/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"hello"}]}'
á¨áááá¨ááááá:
- á˘áááááááááŁáá á¤áĄáááááááááá áŽááááŽáá áá§áááááá ááááá áááááŁá¨ááááááááĄ, á ááááááĄááŞ
/v1/*áá/api/tags; áááĄáŁáŽáááᥠáĄá˘á áŁáĽá˘áŁá á áŁáŞááááá á áŠááá. - áᣠáááááá˘áĄ ááá ááááŁáá áĄááááŁá áááᥠááŽáá ááááá á ááĽááĄ, áŁááá áá˘ááĄááá áááááááá
Authorization: Bearer ...-áĄ. - URL-áá ááá¤áŁáŤááááŁáá á˘ááááááá á¨áááŤáááá áááááŠáááᥠáŁááŁáá ááĽáĄáᥠááŁá áááááá¨á, áá ááŁááá áᥠááĄá˘áá áááĄá áá OmniRoute-áᥠááá áá áá áĄáááŁá á˘áááááá˘á ááá¨á. áááááŽáááá ááĄááá ááááĄáááááááᥠááá áááá˘áá áá áá á áááááá˘áá¤ááááŞááᥠááááŁáááĄáŽááá á áááááá.
á˘áááááá˘á áá
# ááá§ááááááᥠá˘áááááá˘á ááᥠá¨ááŻáááááᥠáááŚááá (p50/p95/p99 ááááááŁáá áá ááááááá ááĄááááĄ)
GET /api/telemetry/summary
áááĄáŁáŽá:
{
"providers": {
"claudeCode": { "p50": 245, "p95": 890, "p99": 1200, "count": 150 },
"github": { "p50": 180, "p95": 620, "p99": 950, "count": 320 }
}
}
áááŁáŻáá˘á
# á§áááá API áááĄááŚáááᥠáááŁáŻáá˘áᥠáĄá˘áá˘áŁáĄáᥠáááŚááá
GET /api/usage/budget
# áááŁáŻáá˘áᥠááá§ááááá áá áááááŽáááá
POST /api/usage/budget
Content-Type: application/json
{
"apiKeyId": "key-123",
"dailyLimitUsd": 5.00,
"weeklyLimitUsd": 30.00,
"monthlyLimitUsd": 100.00,
"warningThreshold": 0.8,
"resetInterval": "monthly"
}
áĄáĽáááᥠá¨áááá¨ááááá (
setBudgetSchema):apiKeyIdáĄááááááááŁááá;dailyLimitUsd,weeklyLimitUsdáámonthlyLimitUsdááááááááá áĄáŁá ááŞáá á áá áá áŁááá áá§áᥠááŁááá ááá˘á. áá ááĄááááááááŁáá áááááá:warningThreshold(0â1),resetInterval(daily|weekly|monthly),resetTime(HH:MM). áááŤááááááŁáá{keyId, limit, period}áĄá˘á áŁáĽá˘áŁá á ááá áŁááááĄ400 Bad RequestáááĄáŁáŽáĄ.
á˘áááááááᥠááááá˘ááá
ááááááŁáá API áááĄááŚááááĄáááᥠááááĄáááŚáá áŁáá á˘áááááááᥠáááŁáŻáá˘ááá (ááááĄáŽááááááá ááááá áááŞáááŁáá USD-áá ááá¤áŁáŤááááŁáá áááŁáŻáá˘ááĄááá). áááá˘á ááá áŁá¨áŁáááá ááááŽááááᥠááááŁá¨áááááᥠááááá áŽáá áŞááááááá: á ááááĄá᪠áááĄááŚáááᥠáááááááá á áá ááᥠá¤áááŻáá áá¨á ááááá§ááááá ááᥠááááá˘áĄ ááááŚáŹáááĄ, ááááŽáááááá áŁáá á§áá¤ááá ááĽáááá áááĄáŁáŽáá 429 Too Many Requests. ááááá˘ááá á¨áááŤáááá á¨ááááá¤áá áááᥠááááá áá˘áŁáá model-áá, provider-áá áá ááááá§áááááŁá ááĽááᥠglobaláŁá áá ááááá áááĄááŚááááĄááááĄ; á ááááĄá᪠ááááŽááááᥠá áááááááá ááááá˘á á¨áááĄááááááá, áŁááá áá˘ááĄááá á§áááááá ááááŞá ᥠááááááá.
# áááĄááŚáááᥠá˘áááááááᥠááááá˘áááᥠáŠáááááááááá (ááááŞááᥠáááááááá á á¤áááŻá áᥠááááá§ááááááĄ)
GET /api/usage/token-limits?apiKeyId=key-123
# á˘áááááááᥠááááá˘áᥠá¨ááĽááá áá áááááŽáááá
POST /api/usage/token-limits
Content-Type: application/json
{
"apiKeyId": "key-123",
"scopeType": "model",
"scopeValue": "openai/gpt-4o",
"tokenLimit": 1000000,
"resetInterval": "monthly",
"enabled": true
}
# á˘áááááááᥠááááá˘áᥠáŹáá¨áá id-áᥠáááŽááááá
DELETE /api/usage/token-limits?id=tl-abc
áĄáĽáááᥠá¨áááá¨ááááá (
setTokenLimitSchema):apiKeyIdááscopeType(model|provider|global) áĄááááááááŁááá.scopeValueáĄááááááááŁááá, ááá áá áá á¨ááááŽáááááĄá, á ááááĄááŞscopeTypeáá ááĄglobal(ááá., ááááááᥠidmodeláááĽááááááᥠáĄá¤áá ááĄááááĄ, áá ááááááá áᥠidprovideráááĽááááááᥠáĄá¤áá ááĄááááĄ).tokenLimitáŁááá áá§áᥠáááááááá ááááá á ááŞáŽáá (áĄá˘á ááĽáááááá ááá áááĽááááá). áá ááĄááááááááŁáá áááááá:id(á¨ááĽááááĄáᥠááááá˘áááá, áááááŽáááááĄáᥠáááŁááááá),resetInterval(daily|weekly|monthly, ááááŁáááĄáŽáááá áááá¨áááááááámonthly),resetTime(HH:MM),enabled(ááááŁáááĄáŽáááá áááá¨áááááááátrue).GETáááĄáŁáŽááá ááááááŁá ááááá˘áĄ áááááá ááᥠááááááátokensUsed,remaining,windowStart,periodStartAtáánextResetAt. áᥠááá áááᥠááááĄáᥠáĄáááááá áŹáá á˘áááá (áááááá˘áá¤ááááŞáá áŞááá˘á áááááááŁááá áááá˘á áááááá ááá˘áá ááááŞááᥠáááááááá áᥠáááá ).
ááááŽááááᥠááááŁá¨ááááá
- áááááá˘á áááááááᥠááááŽáááááĄ
/v1/*-áá - ááá á¨á áŁá˘áᥠáááááŁá¨ááááááá ááŤááŽáááĄ
handleChat,handleEmbedding,handleAudioTranscriptionááhandleImageGenerationá¤áŁááĽáŞááᥠ- áááááĄáááŚáá ááá áááááá (ááá ááááá á provider/model áá alias/combo)
- ááá˘áá ááááŞááᥠáááááŞááááá á¨ááá áŠááá ááááááŁá á DB-ááá, ááááá áá¨áᥠáŽáááááĄááŹáááááááᥠá¤ááá˘á ááŞááᥠááááá§áááááá
- áŠáá˘ááĄááááĄ:
handleChatCoreááááŹáááᥠáĄááááá˘áááŁá /áŽáááááŹáá áᥠáĽáá¨áĄ áá ááááĄáááŚáá ááᥠcombo-ᥠá¨áááŁáá¨ááᥠááá áááá˘á ááᥠ- áŠáá áááᥠá¨ááááŽááááá¨á, áá áááĽá˘ááŁá á á¨áááŁáá¨áá áĄá áŁááááá áá ááááááá áᥠá¤áá ááá˘á¨á ááá áááĽáááááá (
lite, Caveman, RTK áá áááááááá áááŁáá) - áá ááááááá áᥠá¨áááĄá áŁáááááá ááááŽááááᥠáááá ááááᥠáĄáá áááĄá¨á ááááááááĄ
- áááĄáŁáŽá ááá ááááĽááááá áááááá˘áᥠá¤áá ááá˘á¨á (áŠáá˘á) áá áŁáŞáááááá áá áŁááááá (áŠáá¨ááááááá/áĄáŁá ááááá/ááŁááá)
- ááááá§ááááá, á¨áááŁáá¨ááᥠáááááá˘ááá áá ááááŽááááᥠááŁá áááááá ááŚáá ááŞáŽááá
- á¨ááŞááááááᥠá¨ááááŽááááá¨á, combo-ᥠáŹááĄáááᥠá¨ááĄááááááĄáá áááááá§ááááá áĄáá áááá áá ááá áááá˘á
áá áĽáá˘ááĽá˘áŁá áᥠáĄá áŁáá áŞááááá á: ARCHITECTURE.md
Combo-ᥠááá ááá
áŁá¤á á áááŚááá ááááᥠááá á¨á áŁá˘ááááŞááᥠcombo-ááá (áŁááá á¨ááŻáááááŁáá /api/combos*-áᥠáĽááá¨) ááĄááá á¨áááŤáááá 1:1 ááááá¤áá ááááá áááááᥠááááááᥠid-áᥠá¨ááááááĄ, á á᪠OpenAI-áᥠáĄá˘áááᥠááááááᥠid-áᥠcombo-áá ááááááá ááááá áááááááĄáááá ááááᥠáĄáá¨áŁáááááᥠááŤáááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/model-combo-mappings |
á§áááá modelâcombo á¨ááĄááááááĄáááᥠáŠáááááááááá |
| POST | /api/model-combo-mappings |
á¨ááĄááááááĄáááᥠá¨ááĽááá â áĄáŽááŁáá: {pattern, comboId, priority?, enabled?, description?} |
| GET | /api/model-combo-mappings/[id] |
áá áá á¨ááĄááááááĄáááᥠáááŚááá |
| PUT | /api/model-combo-mappings/[id] |
áá áĄáááŁáá á¨ááĄááááááĄáááᥠááááááᥠáááááŽáááá |
| DELETE | /api/model-combo-mappings/[id] |
á¨ááĄááááááĄáááᥠáŹáá¨áá |
áááááá˘áá¤ááááŞáá: ááá áááᥠáĄááĄáá/API áááĄááŚááá (requireManagementAuth).
áááá°áŁáááá
OmniRoute-áᥠááááááááááĄáááᥠáááááááá áááá°áŁááááᥠáááááŹáá ááá (ááááŽááááᥠáááĄá áŁáááá, áááá˘áᥠááááŹáŁá áá, áááĄááŚáááᥠá áá˘ááŞáá áá á.á¨.).
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/webhooks |
áááá°áŁááááᥠáĄáá (áĄááááŁáááááááá á¨ááááŚááŁááá, á áááá ᪠<prefix>...) |
| POST | /api/webhooks |
áááá°áŁááᥠá¨ááĽááá â áĄáŽááŁáá: {url, events?: ["*"], secret?, description?} |
| GET | /api/webhooks/[id] |
áááá°áŁááᥠáááŚááá |
| PUT | /api/webhooks/[id] |
url/events/secret/description-áᥠáááááŽáááá |
| DELETE | /api/webhooks/[id] |
áááá°áŁááᥠáŹáá¨áá |
| POST | /api/webhooks/[id]/test |
áĄáá˘ááĄá˘á ááá˘ááá áááᥠáááááááá áááá°áŁááᥠURL-áá áá áááŹáááááᥠáĄá˘áá˘áŁáĄáᥠáááá áŁáááá |
áááááá˘áá¤ááááŞáá: ááá áááᥠáĄááĄáá/API áááĄááŚááá (requireManagementAuth).
á ááááĄá˘á áá áááŁáá áááĄááŚááááá (ááá˘áááá˘áŁá á ááá ááá)
áááááá§ááááá áááĄááŚáááááᥠááá˘áááá˘áŁá á ááá áááᥠáĽáááĄááĄá˘áááᥠáááá , á ááá áŁáá áŁááááá§áᥠAPI áááĄááŚáááááᥠáááŞááá áá á áá˘ááŞáá ááááŽááá á áá ááááááá ááĄ/ááááá áá¨áᥠááá¨áááááá, á§ááááááŚááŁá á/áĄáááááá ááá áááá˘áááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/v1/registered-keys |
á ááááĄá˘á áá áááŁáá áááĄááŚáááááᥠáĄáá (ááŽáááá á¨ááááŚááŁáá áá áá¤ááĽáĄá) |
| POST | /api/v1/registered-keys |
ááŽááá á ááááĄá˘á áá áááŁáá áááĄááŚáááᥠáááŞááá â áĄáŽááŁáá: {name, provider?, accountId?, idempotencyKey?, expiresAt?, dailyBudget?, hourlyBudget?}. áááŁááŁá¨áááááá áááĄááŚááᥠááá áŁáááᥠáá ááŽáá. áááá˘áᥠáááá áŁáá áᥠá¨ááááŽááááá¨á ááá áŁáááᥠ429-áĄ. |
| GET | /api/v1/registered-keys/[id] |
á ááááĄá˘á áá áááŁáá áááĄááŚáááᥠááá˘ááááááŞáááááᥠáááŚááá (áááŁááŁá¨ááááááá áááá¨áááááááᥠááá áá¨á) |
| DELETE | /api/v1/registered-keys/[id] |
á ááááĄá˘á áá áááŁáá áááĄááŚáááᥠáááŁáĽáááá |
| POST | /api/v1/registered-keys/[id]/revoke |
áááŁáĽááááᥠáŞáááá áĄáááááá áŹáá á˘ááá (ááááá áá¤ááĽá˘á, á á᪠DELETE-áĄ) |
áááááá˘áá¤ááááŞáá: Bearer API áááĄááŚááá (isAuthenticated). ááĄááá ááŽáááá /v1/quotas/check áá /v1/issues/report.
ááááá˘áááᥠáá áá˘ááááá
Cloud-ááááá˘áᥠááááŞááááá (Claude Code, Codex Cloud, OpenHands áá áĄáŽá.), á áááááá᪠OmniRoute-áᥠááááŽááá ááááááᥠáĄááŽáááá áááĄá˘áááŞááŁá áá áĄá áŁááááá.
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/v1/agents/tasks |
ááááŞáááááᥠáĄáá â áá ááĄááááááááŁáá ?provider=, ?status=, ?limit= (1â500, ááááŁáááĄáŽááááá 50) |
| POST | /api/v1/agents/tasks |
ááááŞáááᥠá¨ááĽááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá CreateCloudAgentTaskSchema-áá (providerId, prompt, source, options?). ááá áŁáááᥠ201-ᥠááááŞáááᥠáááááá á˘áá |
| DELETE | /api/v1/agents/tasks?id=... |
ááááŞáááᥠáŹáá¨áá |
| GET | /api/v1/agents/tasks/[id] |
ááááŞáááᥠáŹáááááŽáá â á ááááĄá᪠external_id ááá§áááááŁááá, áĄáááĽá áááŁááá ááááááŽáááᥠáĄá˘áá˘áŁáĄáĄ áááá ááááᥠCloud-ááááá˘áááá |
| POST | /api/v1/agents/tasks/[id] |
áááĄáá áááááá áááŁáá áááĽáááááá: {action: "approve"}, {action: "message", message}, áá {action: "cancel"} |
| DELETE | /api/v1/agents/tasks/[id] |
ááááá áá˘áŁáá ááááŞáááᥠáŹáá¨áá id-áᥠáááŽááááá |
áááááá˘áá¤ááááŞáá: ááááááŁáá áááááááĄáááᥠáĄáááá áá ááá áááᥠáááááá˘áá¤ááááŞáá (
requireCloudAgentManagementAuth). v3.8.0-ááá áᥠáááááááá áááááá˘áá¤ááááŞááᥠáá áĄáááá ááááá â á¨ááŁááááĄááááá áŞááááááááĄáááᥠááŽáááá ááááá˘á588a0333.
# Claude Code-áᥠCloud-ááááŞáááᥠá¨ááĽááá
curl -X POST http://localhost:20128/api/v1/agents/tasks \
-H "Authorization: Bearer your-management-key" \
-H "Content-Type: application/json" \
-d '{"providerId":"claude-code-cloud","prompt":"Fix the failing test","source":{"repo":"...","branch":"..."}}'
ááá áááᥠáá ááĽáĄáááá
áááááááá HTTP(S)/SOCKS áá ááĽáĄáááá, á áááááá᪠á¨áááŤáááá áááááááᥠáá ááááááá áááĄ, ááááá áá¨ááᥠáá áááááááŁá áá.
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/v1/management/proxies |
áá ááĽáĄááááᥠáĄáá (?id=-áá ááá áŁáááᥠáá ááĄ; ?id=&where_used=1-áá ááá áŁáááᥠááááááááááᥠáá áá¤áĄ) |
| POST | /api/v1/management/proxies |
áá ááĽáĄáᥠá¨ááĽááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá createProxyRegistrySchema-áá |
| PATCH | /api/v1/management/proxies |
áá ááĽáĄáᥠáááááŽáááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá updateProxyRegistrySchema-áá (áĄáááá áááᥠid-áĄ) |
| DELETE | /api/v1/management/proxies?id=...&force=1 |
áá ááĽáĄáᥠáŹáá¨áá (ááááááááááᥠáááĄááŽáĄááááá áááááá§áááá force=1) |
| GET | /api/v1/management/proxies/assignments |
ááááááááááᥠáĄáá â áá¤ááá˘á ááá proxy_id, scope, scope_id ááááááá; áááá¨áá ááĄáááᥠááĽá˘ááŁá á áá ááĽáĄáᥠááááĄáááŚáá ááĄáááᥠáááŁááááá resolve_connection_id=<id> |
| PUT | /api/v1/management/proxies/assignments |
áááááááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá proxyAssignmentSchema-áá ({scope, scopeId?, proxyId?}). ááĄáŁá¤áááááᥠáááĄááá˘áŠáá áᥠááá¨áĄ |
| PUT | /api/v1/management/proxies/bulk-assign |
áááĄááá ááá áááááááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá bulkProxyAssignmentSchema-áá ({scope, scopeIds[], proxyId?}) |
| GET | /api/v1/management/proxies/health?hours=24 |
áá ááᥠáááŞáááŁá ááááááááá¨á áá ááĽáĄáᥠááááááá ááááᥠááá áááá áááŁáá áááááŞááááá (áŹáá ááá˘áááŁáá/áŹáá áŁááá˘ááááá ááŞááááááááᥠá áááááááá, ááá§áááááá) |
áááááá˘áá¤ááááŞáá: ááááááŁá ááá á¨á áŁá˘áá áĄáááá áá ááá áááᥠáĄááĄáá/API-áááĄááŚááá (requireManagementAuth).
ááááŞáááᥠááŚáŹáá áá¨á ááááááááŁá
POST /api/v1/management/proxies/[id]/assignmentsááPOST /api/v1/management/proxies/[id]/healthááá á¨á áŁá˘ááᥠááááá áááŠáááááá áá á˘á§ááá/assignmentsáá/healthááá á¨á áŁá˘ááá áááĄááŽáŁá ááá â ááááŁá ááááá¨á áŞáááááŁáá id-áᥠáĽááááá á¨á áŁá˘ááá áá áá áĄáááááĄ.
áááá ááááá (ááá¤áá áááááŁáá)
OmniRoute áŁáá áŁááááá§áá¤áĄ áá áááááá á¨áá¤áá áŽáááááᥠááááŁá¨áááááᥠáĄáá áááááŁááááááá áááĽááááááĄ; áĽááááá áááŞáááŁáá ááá áááᥠáĄáááááá áŹáá á˘ááááá áááá áá˘áá ááᥠáááá ááááááá ááááᥠáŹáááááŽáááĄá áá ááá áááá˘á áááᥠáŽáááá á¨ááŞáááᥠáĄáá¨áŁáááááᥠááŤááááĄ:
| áááĽááááááᥠáá áááá | ááááááá ááááᥠáĄááŞááá | áŹáááááŽáá | ááááá˘ááá ááá / áááĄáŁá¤áááááá |
|---|---|---|---|
| áá ááááááá áᥠááááá ááááá | domain_circuit_breakers + áááá áá˘ááŁá áááŽáĄááá áááá¨á |
/api/monitoring/health |
POST /api/resilience/reset |
| áááá¨áá áᥠááá§áááááá | rateLimitedUntil áá ááááááá áᥠáááá¨áá áááá |
/api/rate-limits, /api/providers/[id] |
(áŽááááŽáá ááĽá˘ááŁá áááá áĄáááá áááááĄááĄ; áááĄáŁá¤áááááá á¨ááĄááŤááááááá áá ááááááá áᥠPUT-áá) |
| ááááááᥠáááááá ááá | áááá áá˘ááŁá áááŽáĄááá áááá¨á áá áĄáááŁáá ááááááááᥠáŽáááááĄááŹáááááááᥠá áááĄá˘á á | GET /api/resilience/model-cooldowns |
DELETE /api/resilience/model-cooldowns |
PATCH /api/resilience ááŚááᥠáá ááááááá áᥠááááá áááááᥠáŠááááŞáááááá ááá áááá˘á ááᥠproviderBreaker.oauth-áĄá áá providerBreaker.apikey-á¨á. ááááááŁáá áá áá¤ááá ááŽáá ᥠáŁááá ᥠdegradationThreshold, failureThreshold áá resetTimeoutMs ááááááĄ; ááááá áááááá áŽáááááĄááŹáááááá Dashboard â Settings â Resilience-á¨á.
# áá áá ááááááᥠáááááá áááᥠáááĄáŁá¤áááááá
curl -X DELETE http://localhost:20128/api/resilience/model-cooldowns \
-H "Cookie: auth_token=..." \
-H "Content-Type: application/json" \
-d '{"provider":"openai","model":"gpt-4o-mini"}'
# á§áááá áááááá áááᥠáŹáá¨áá
curl -X DELETE http://localhost:20128/api/resilience/model-cooldowns \
-H "Cookie: auth_token=..." \
-d '{"all":true}'
áĄá áŁáá ááááŞááá˘áŁáááŁá á áŞááááá ááĄá áá ááááá áááááᥠááááŁáááĄáŽáááá ááá áááá˘á ááááĄáááᥠááŽáááá CLAUDE.md â "Resilience Runtime State".
áŁááá ááá
áŁááá áááᥠáŠáá áŠá OmniRoute-áᥠááá ááááŁáá á¨ááĄá áŁáááááá áááááŁá¨ááááááááá áááĄáá¤áá ááááááá, ááá áááá ááá ááá˘áááááĄáᥠááá˘ááá ááŞáááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/skills |
áááááĄá˘áááá áááŁáá áŁááá áááᥠáĄáá â ááá¤ááá˘áá á á¨ááĄááŤááááááá ?q=, ?mode=on|off|auto, ?source=skillsmp|skillssh|local ááá áááá˘á áááá; ááŽáá ááááá áááá áááá ááááá ááá§áá¤á |
| GET | /api/skills/[id] |
áá áá áŁááá áᥠáááŚááá |
| PUT | /api/skills/[id] |
áŁááá áᥠáááááŽáááá (áĄááŽááá, ááŚáŹáá á, á ááááá, áĄáĽááá, áááááŁá¨ááááááá, á˘ááááá) |
| DELETE | /api/skills/[id] |
áŁááá áᥠáááááĄá˘ááááŞáá |
| POST | /api/skills/install |
áŁááá áᥠááá§ááááá áááŁááŁá¨ááááááá ááááá¤ááĄá˘áááá â ááááŽááááᥠáĄáŽááŁáá: {name, version, description, schema:{input, output}, handlerCode, apiKeyId?} |
| GET | /api/skills/executions |
áŁááá áááᥠáááá á¨ááĄá áŁááááááᥠáĄáá (ááŁááá˘áᥠááŁá áááá á¨áá§áááááá/ááááá˘ááááá áááááŞááááááá áá áŽáááá áŤááááááá) |
| GET | /api/skills/marketplace?q=... |
áŤáááá/ááááŁááá áŁáá ááááááá˘áááᥠáĄáá SkillsMP ááá ááá˘áááááĄáááá (áĄáááá áááᥠskillsmpApiKey ááá áááá˘á áĄ) |
| POST | /api/skills/marketplace/install |
áŁááá áᥠááá§ááááá SkillsMP-ááá id-áᥠáááŽááááá |
| GET | /api/skills/skillssh?q=&limit= |
áŤáááá skills.sh á áááĄá˘á á¨á |
| POST | /api/skills/skillssh/install |
áŁááá áᥠááá§ááááá skills.sh-ááá id-áᥠáááŽááááá |
áááááá˘áá¤ááááŞáá: ááá áááᥠáĄááĄáá/API áááĄááŚááá. ááá ááá˘áááááĄáᥠáĄááŤáááá ááá á¨á áŁá˘ááá ááŚááᥠá áááá ᪠ááá áááᥠáááááá˘áá¤ááááŞáááĄ, ááĄá Bearer API áááĄááŚááᥠ(isAuthenticated).
áááŽáĄááá ááá
ááŁááááá áĄááĄááŁáá á/á¤ááĽá˘ááá ááá áááŽáĄááá áááᥠáĄááŞááá, á ááááᥠáááĽááááááᥠáá á ááááááŁáá API áááĄááŚáááá / áĄááĄááá áááááĄáááŚáá ááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/memory |
áááŽáĄááá áááᥠáŠááááŹáá áááᥠáĄáá â ?apiKeyId=, ?type=, ?sessionId=, ?q=, offset/limit áá page/limit áááá ááááá ááá§áá¤áá |
| POST | /api/memory |
áááŽáĄááá áááᥠáŠááááŹáá áᥠá¨ááĽááá â ááááŽááááᥠáĄáŽááŁáá áááŹááááá Zod-áᥠáááá : {content, key, type?, sessionId?, apiKeyId?, metadata?, expiresAt?} |
| GET | /api/memory/[id] |
áááŽáĄááá áááᥠáá áá áŠááááŹáá áᥠáááŚááá |
| DELETE | /api/memory/[id] |
áááŽáĄááá áááᥠáŠááááŹáá áᥠáŹáá¨áá |
| GET | /api/memory/health |
áááŽáĄááá áááᥠáĽáááĄááĄá˘áááᥠááááááá áááá (DB-áĄááá áááá¨áá á, embeddings-áᥠáááĽáááá, áááĽá˘áá áŁáá áááááĽáĄáᥠáĄá˘áá˘áŁáĄá) |
ááá˘áá ááááŞáá: ááá áááᥠáĄááĄáá/API áááĄááŚááá (requireManagementAuth). type áŠáááááááááá: FACTUAL, EPISODIC, SEMANTIC, PROCEDURAL (ááŽáááá MemoryType á¤áááá¨á src/lib/memory/types.ts).
MCP áĄáá ááá á
OmniRoute-ᥠááá°á§áááá áŠáá¨áááááŁáá Model Context Protocol áĄáá ááá á 3 á˘á áááĄááá á˘áá (stdio, SSE, streamable-http) áá áááĽááááááᥠáá áá á¨áááŚáŁááŁáá áŽáááĄááŹá§ááááá. áĽááááá áááŞáááŁáá ááá¤áᥠáĄáááááá áŹáá á˘ááááá ááááŽáŁáááᥠáĄá˘áá˘áŁáĄááĄ/ááŁááá˘áᥠáááááŞááááᥠáá HTTP á˘á áááĄááá á˘ááááĄáááᥠáá ááĽáĄáᥠá¤áŁááĽáŞááᥠááĄá áŁááááĄ.
| áááááá | ááá | ááŚáŹáá á | |
|---|---|---|---|
| GET | /api/mcp/status |
ááá ááááŁáá áĄáááááá, á˘á áááĄááá á˘á, áááááá-ááááááá áááá, áááá áááááŤááŽááá, á§áááááá áŽá¨áá áá ááááá§áááááŁáá áŽáááĄááŹá§áááá, áááá 24 áĄááááᥠáŹáá ááá˘áááᥠáááŠáááááááá | |
| GET | /api/mcp/tools |
MCP áŽáááĄááŹá§ááááᥠáĄáá ááááááá name, description, scopes, phase, auditLevel, sourceEndpoints |
|
| GET | /api/mcp/sse |
SSE á˘á áááĄááá á˘ááĄáááᥠSSE ááááááᥠáááŽáĄáá (ááá áŁáááᥠ503-áĄ, áᣠMCP ááááá ááŁááá áá á˘á áááĄááá á˘á áá ááááŽáááá) |
|
| POST | /api/mcp/sse |
JSON-RPC á¤á ááááᥠáááááááá SSE á˘á áááĄááá á˘áá | |
| GET | /api/mcp/stream |
Streamable HTTP á˘á áááĄááá á˘áᥠSSE ááŽáá áᥠáááŽáĄáá (áĄáá ááá áᥠáááá ááááŞááá áááŁáá á¨áá˘á§ááááááááá) | |
| POST | /api/mcp/stream |
JSON-RPC á¤á ááááᥠáááááááá Streamable HTTP á˘á áááĄááá á˘áá | |
| DELETE | /api/mcp/stream |
Streamable HTTP áĄááĄááᥠáááĄá áŁáááá | |
| GET | /api/mcp/audit |
ááŁááá˘áᥠááŁá ááááᥠááááŽáááá â ?limit=, ?offset=, ?tool=, `?success=true |
false, ?apiKeyId=` |
| GET | /api/mcp/audit/stats |
ááŁááá˘áᥠááá áááá áááŁáá áĄá˘áá˘ááĄá˘ááá (áŻáááŁá á áááŠááááááááá, áŹáá ááá˘áááᥠáááŠáááááááá, áĄáá¨áŁááá áŽáááá áŤáááááá, á§áááááá áŽá¨áá áá ááááá§áááááŁáá áŽáááĄááŹá§áááá) |
ááá˘áá ááááŞáá: sse/stream á˘á áááĄááá á˘ááá áá§ááááᥠMCP-áĄáááᥠáĄáááŞáá¤áááŁá ááá˘áá ááááŞááᥠááááááá ᥠ(Bearer API áááĄááŚááá mcp áááĽááááááᥠáá áá); status/tools/audit* ááá á¨á áŁá˘ááá áááááŽááá ááá¤áááá (ááá¤áᥠá°ááĄá˘áá áŹáááááᥠááá áá ááááá˘ááááá ááá˘áá ááááŞáá áĄáááá á áá áá ááĄ).
áá ááá HTTP á˘á áááĄááá á˘á áááá˘á áááááá
settings.mcpEnabled-ááĄá áásettings.mcpTransport-áᥠáĄáá¨áŁáááááá â á˘á áááĄááá á˘áᥠá¨ááŁáĄááááááá ááá áŁááááĄ400-áĄ, áŽááá MCP-áᥠááááá ááŁáá ááááááá áááá â503-áĄ.
A2A áĄáá ááá á
OmniRoute áŁáá áŁááááá§áá¤áĄ A2A (ááááá˘áááá ááááá˘ááá) JSON-RPC 2.0 áááá áŹáá á˘ááᥠáá REST ááá áĄáĄ áááĄáááĽá˘áá ááááĄá áá áĄáááá¤áá áááŞáá áááááá¨á ááááá§ááááááĄááááĄ.
JSON-RPC
POST /a2a
Authorization: Bearer your-api-key # áá ááĄááááááááŁááá, áᣠOMNIROUTE_API_KEY ááá§áááááŁáá áá áá ááĄ
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "message/send",
"params": {
"skill": "smart-routing",
"messages": [{"role": "user", "content": "Route this coding task"}]
}
}
ááŽáá ááááá ááá áááááááá (á§áááá ááááááááááŁááá settings.a2aEnabled-áá):
| áááááá | ááŚáŹáá á |
|---|---|
message/send |
áŁááá áᥠáĄáááĽá áááŁáá á¨ááĄá áŁáááá; ááá áŁáááᥠ{task, artifacts, metadata} |
message/stream |
ááááá áŁááá áááᥠáááá áááᥠááááááŁá á SSE á¨ááĄá áŁáááá |
tasks/get |
ááááŞáááᥠáááŚááá taskId-áá |
tasks/cancel |
ááááŞáááᥠáááŁáĽáááá taskId-áá |
áŠáá¨áááááŁáá áŁááá ááá: smart-routing, quota-management, provider-discovery, cost-analysis, health-report.
ááááá˘áᥠááá ááá
GET /.well-known/agent.json
ááá áŁáááᥠáĄááŻáá á A2A ááááá˘áᥠááá ááᥠ(áĄááŽááá, ááŚáŹáá á, á¨ááĄááŤááááááááá, áŁááá áááᥠááá˘ááááá, áááááá˘áá¤ááááŞááᥠáĄáĽááá) â áĄááŻáá áá ááá¨áá áááá 1 áĄááááá. áááááá˘áá¤ááááŞáá áĄáááá á áá áá ááĄ.
REST ááááŽááá á áááĽáááááááá
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/a2a/status |
A2A-ᥠáŠáá ááŁááááᥠáĄá˘áá˘áŁáĄá + ááááŞáááááᥠáĄá˘áá˘ááĄá˘ááá + ááá¨áá áááŁáá ááááá˘áᥠááá áááᥠá¨ááŻááááá |
| GET | /api/a2a/tasks |
ááááŞáááááᥠáĄáá â ?state=submitted|working|completed|failed|cancelled, ?skill=, ?limit= (â¤200), ?offset= |
| POST | /api/a2a/tasks |
(REST ááááŽááá á áááĽááááááᥠáĄááŽáá áá áá áᥠá ááááááááŁáá â á¨ááĽááááá JSON-RPC message/send-áᥠááá¨áááááá) |
| GET | /api/a2a/tasks/[id] |
áá áá ááááŞáááᥠáááŚááá |
| POST | /api/a2a/tasks/[id]/cancel |
ááááŞáááᥠáááŁáĽáááá |
áááááá˘áá¤ááááŞáá: REST ááááŽááá á áááĽáááááááá ááá áááᥠáááááá˘áá¤ááááŞááᥠááá áá¨á ááŁá¨áááᥠ(áŹáááááŽááááá áĄáááá¤áá áááŞáá ááááááááá); JSON-RPC /a2a ááá á¨á áŁá˘á áá§ááááᥠBearer OMNIROUTE_API_KEY-áĄ, áᣠáᥠáááá¤áááŁá áá áááŁááá.
áŚá áŁáááá, á¨áá¤ááĄááááá á˘ááĄá˘ááá áá á¨áá¤ááĄááá
| áááááá | áááĄáááá áá | ááŚáŹáá á | ||
|---|---|---|---|---|
| POST | /api/cloud/auth |
ááááŹáááᥠBearer áááĄááŚááᥠáá áŚá áŁáááááá áĄáááĽá ááááááŞááᥠáááááá˘ááááĄáááᥠááá áŁáááᥠáá ááááááá áááᥠá¨ááááŚááŁá áááá¨áá áááĄá áá ááááááááᥠá¤áĄáááááááááᥠ| ||
| POST | /api/cloud/credentials/update |
áááŽáááᥠááá¨áá¤á áŁá ááá˘áá ááááŞááᥠáááááŞááááᥠáŚá áŁáááááá áĄáááĽá áááááááŁáá áá ááááááá ááĄáááᥠ| ||
| POST | /api/cloud/model/resolve |
áááááááá ááá ááá á¨á áŁá˘ááááŞááᥠáŞáŽá áááᥠááááá§áááááá ááááááŁá ááááááᥠID-ᥠááááá áá˘áŁá áá ááááááá áá/ááááááá ááá áááĽáááᥠ| ||
| GET | /api/cloud/models/alias |
áŠáááááááᥠááááááááᥠá¤áĄááááááááááĄ, á áááááá᪠áŽáááááĄááŹáááááá áŚá áŁáááááá áĄáááĽá ááááááŞáááĄáááᥠ| ||
| GET | /api/assess |
ááááŽáŁáááᥠáŁááŽáááĄá á¨áá¤ááĄáááᥠááá˘áááá ááááŞáááᥠ(ááááááŁáá áá ááááááá ááĄ/ááááááᥠáááŽááááá) | ||
| POST | /api/assess |
ááĄá áŁáááᥠá¨áá¤ááĄáááᥠâ ááááŽááááᥠáĄáŽááŁáá: `{scope: {type:"all"} | {type:"provider", providerId} | {type:"model", modelId}, trigger?}` |
| GET | /api/evals |
áŠáááááááᥠáŠáá¨áááááŁá á¨áá¤ááĄááááá á˘ááĄá˘áááᥠáááááááĽá˘áááĄá áá áŁááŽááᥠááá¨áááááᥠ| ||
| POST | /api/evals |
ááŹá§ááᥠá¨áá¤ááĄááááá á˘ááĄá˘áᥠááá¨ááááᥠ| ||
| POST | /api/evals/suites |
áĽáááᥠááá ááááŁá á¨áá¤ááĄááááá á˘ááĄá˘áááᥠáááááááĽá˘áĄ â ááááŽááááᥠáĄáŽááŁáá áááŹááááá evalSuiteSaveSchema-áá |
||
| GET | /api/evals/suites/[id] |
ááŚááᥠááá ááááŁá á¨áá¤ááĄááááá á˘ááĄá˘áááᥠáááááááĽá˘áĄ |
áááááá˘áá¤ááááŞáá: /api/cloud/auth ááá ááááá ááááŹáááᥠBearer áááĄááŚáááĄ; ááááá áŠááá /api/cloud/*, /api/evals/* áá /api/assess ááá á¨á áŁá˘ááá áááááŽááᥠááá áááᥠáĄááĄáááĄ/API áááĄááŚáááĄ. /api/assess POST áá§ááááᥠvalidateBody-ᥠáááĄáá áááááá áááŁáá áááá áááááááᥠá˘áááᥠáááĽááááááᥠáá ááááᥠáĄáĽááááĄááá áá ááá.
ACP-áᥠ(Agent Client Protocol) ááá ááá
á áááá ᪠á¨áááááááá áá ááŞááĄááá. áᥠáĄáááááá áŹáá á˘ááááá ááá áááᥠACP ááááá˘áááᥠááŚáááŠááááĄá áá ááá ááááŁáá ááááá˘áááᥠá ááááĄá˘á ááŞáááĄ.
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/acp/agents |
á§áááá áŞáááááá CLI ááááá˘áᥠ(áŠáá¨áááááŁáá + ááá ááááŁáá) áĄáá áááĄá˘ááááŞááᥠáĄá˘áá˘áŁáĄáá, ááá áĄáááá áá ááááá áŁáá á¤ááááá |
| POST | /api/acp/agents |
ááá ááááŁáá ACP ááááá˘áᥠá ááááĄá˘á ááŞáá áá áĽáá¨áᥠáááááŽáááá â áĄáŽááŁáá: {id, name, binary, versionCommand, providerAlias, spawnArgs, protocol} áá {action: "refresh"} |
| DELETE | /api/acp/agents |
ááá ááááŁáá ACP ááááá˘áᥠáŹáá¨áá â ááááŽááááᥠááá áááá˘á á: ?id=<agentId> |
áááĄáŁáŽáᥠáááááááá (GET /api/acp/agents):
{
"agents": [
{
"id": "claude",
"name": "Claude Code CLI",
"binary": "claude",
"version": "1.0.45",
"installed": true,
"protocol": "stdio",
"providerAlias": "claude",
"isCustom": false
},
{
"id": "my-custom-cli",
"name": "My Custom CLI",
"installed": false,
"protocol": "stdio",
"providerAlias": "my-provider",
"isCustom": true
}
],
"cacheTtlMs": 60000,
"cacheAge": 1234
}
áááááá˘áá¤ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá (ááá áááᥠááááááᥠauth_token cookie) áá
ááá áááᥠáá ááá á¨áááŚáŁááŁáá API áááĄááŚááá.
áĄá áŁáá ááá˘ááááááĄáááᥠááŽáááá ACP áŠáá áŠá.
áááááá˘ááá áá áááááá áááááááá
á ááááŁá áá áá¨á áááĽáááá áááááá˘áááᥠáĄáááááá áŹáá á˘ááááá ááá á¨á áŁá˘ááááŞáááĄ, á¨áááŁáá¨áááĄá áá áá ááááááá ááááĄ
áá ááááá¤áá ááááááᥠááááá˘áá áááááĄááááĄ. ááĄááá áŁáá áŁááááá§áá¤áĄ /dashboard/analytics/* áááá ááááᥠááŁá¨áááááĄ.
ááá˘áááá˘áŁá á ááá á¨á áŁá˘ááááŞááᥠáááááá˘ááá
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/analytics/auto-routing |
ááá˘áááá˘áŁá á ááá á¨á áŁá˘ááááŞááᥠááá áááá áááŁáá áĄá˘áá˘ááĄá˘ááá: áááááŤááŽáááááᥠáŻáááŁá á á áááááááá, áĄá˘á áá˘ááááááᥠáááááŹááááá, áááááááᥠáááááŹááááá, áŹááá§áááá áá ááááááá ááá |
| GET | /api/analytics/auto-routing?days=7 |
áá ááᥠá¤áááŻá áá á¨áááŚáŁááŁáá áĄá˘áá˘ááĄá˘ááá (ááááŁáááĄáŽááááá 24 áĄá) |
áááĄáŁáŽáᥠáááááááá:
{
"window": "24h",
"totalCalls": 1234,
"strategyBreakdown": {
"rules": 800,
"cost": 200,
"latency": 150,
"sla-aware": 50,
"lkgp": 34
},
"tierBreakdown": {
"ultra": 100,
"pro": 500,
"standard": 400,
"free": 234
},
"topProviders": [
{ "provider": "openai", "calls": 500, "avgLatencyMs": 850 },
{ "provider": "anthropic", "calls": 300, "avgLatencyMs": 1200 }
]
}
á¨áááŁáá¨ááᥠáááááá˘ááá
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/analytics/compression |
á¨áááŁáá¨ááᥠááá áááá áááŁáá áĄá˘áá˘ááĄá˘ááá: áááááááá á˘ááááááá, áááááááᥠ%, á áááááááᥠáááááŹááááá, áŤá áááááᥠááááá§ááááá |
áááĄáŁáŽáᥠáááááááá:
{
"window": "24h",
"totalOriginalTokens": 5000000,
"totalCompressedTokens": 3500000,
"totalSavings": 1500000,
"savingsPct": 30.0,
"modeBreakdown": {
"lite": 400,
"standard": 600,
"aggressive": 100,
"ultra": 50,
"rtk": 84
},
"engineBreakdown": {
"caveman": 800,
"rtk": 434
}
}
áá ááááááá áááᥠáá ááááá¤áá ááááááᥠááááá§áŁá áᥠááááááá
| áááááá | áááĄáááá áá | ááŚáŹáá á |
|---|---|---|
| GET | /api/analytics/diversity |
á¨áááááᥠááá˘á áááááá ááá¤áŁáŤááááŁáá áá ááááá¤áá ááááááᥠááááá§áŁá áᥠááááááá: áá ááááááá áááᥠáááááŹáááááᥠáááááááá ááááááá ááŞááááᥠáá áááŁá ááá áŞáŽáᥠáŹáá á˘ááááᥠ|
áááĄáŁáŽáᥠáááááááá:
{
"window": "24h",
"shannonEntropy": 2.45,
"maxEntropy": 3.17,
"diversityRatio": 0.77,
"providerUsage": {
"openai": 0.4,
"anthropic": 0.25,
"google": 0.2,
"kiro": 0.15
},
"warnings": ["OpenAI accounts for 40% of traffic â consider diversifying"]
}
áááááá˘áá¤ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá áá ááá áááᥠáá ááá á¨áááŚáŁááŁáá API áááĄááŚááá.
áááááááĄá˘á áá˘áá áᥠáááá ááŞáááá
áááá ááŞááŁáá ááá áááᥠááŽáááá áááááááĄá˘á áá˘áá ááĄáááᥠáááááŁáááááá endpoint-ááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/admin/concurrency |
áááááŁá ááá˘áŁááááᥠáááááááá á ááááá˘áááᥠáŹáááááŽáá (áááááááŁá á + ááááááŁáá áá ááááááá ááĄááááĄ) |
| POST | /api/admin/concurrency |
áááááŁá ááá˘áŁááááᥠááááá˘áááᥠáááááŽáááá â body: {global?: number, perProvider?: Record<string, number>} |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá áááááááĄá˘á áá˘áá áᥠscope-áá.
CLI áááĄá˘á áŁáááá˘áááᥠááá ááá
ááá ááá CLI áááĄá˘á áŁáááá˘ááá, á áááááá᪠OmniRoute-ááá ááá˘ááá áá áááá (antigravity, chipotle, commandCode, devin-cli áá áĄáŽá.). áĄá áŁáá áĄáááĄáááᥠááŽáááá áá ááááááá áᥠáŞááááá á.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/cli-tools/all-statuses |
á§áááá CLI áááĄá˘á áŁáááá˘áᥠáĄá˘áá˘áŁáĄá (áááááĄá˘áááá áááŁáá ááááááá áááá, ááá áĄáá, áááá áááááŠááá) |
| GET | /api/cli-tools/status |
áá áá CLI áááĄá˘á áŁáááá˘áᥠáĄá˘áá˘áŁáĄáᥠááá˘ááááá (?tool= query) |
| POST | /api/cli-tools/apply |
áááĄá˘á áŁáááá˘áᥠááááá áá áááŁáá áááá¤áááŁá ááŞááᥠáŠááŹáá á (dryRun ááŠáááááᥠáŹááááĄáŹáá á¨áááááĄ; áááá˘ááááá á¨á ááá¨áááááĄáᥠâ 422 + containerEphemeralTarget; migration áááŁáááááᥠáááŤááááááŁá Codex YAML-áá) |
| GET | /api/cli-tools/backups |
CLI áááĄá˘á áŁáááá˘áááᥠáááá¤áááŁá ááŞááᥠáĄáá áááá áá ááĄááááᥠáŠáááááááááá |
| POST | /api/cli-tools/backups |
á§áááá CLI áááĄá˘á áŁáááá˘áᥠáááá¤áááŁá ááŞááᥠáĄáá áááá áá ááĄááᥠá¨ááĽááá |
| POST | /api/cli-tools/backups |
ááŚááááá: ááááá endpoint body-á¨á {tool, backupId}-áá ááŚáááááᥠá¨ááĄáááááᥠáĄáá áááá áá ááĄáᥠ|
| GET | /api/cli-tools/antigravity-mitm |
Antigravity MITM áá ááĽáĄáᥠáĄá˘áá˘áŁáĄá (antigravity-mitm CLI áááĄá˘á áŁáááá˘á) |
| POST | /api/cli-tools/antigravity-mitm/alias |
antigravity-mitm-áᥠalias-áááᥠáááá¤áááŁá ááŞáá |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá.
ááááá˘áᥠáŁááá ááá
ááá ááá AI ááááá˘áᥠáŁááá ááá (OpenAI-áᥠááá ááááŁáá GPT-áááᥠááĄááááĄá, áááá áá ááááá˘ááááĄááááĄ).
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/agent-skills |
ááááá˘áᥠá§áááá áŁááá áᥠáŠáááááááááá (áŠáá¨áááááŁáá + ááá ááááŁáá) |
| GET | /api/agent-skills/[id] |
ááááá˘áᥠááááá áá˘áŁáá áŁááá áᥠáááŚááá |
| POST | /api/agent-skills |
ááááá˘áᥠááá ááááŁáá áŁááá áᥠá¨ááĽááá â body: {name, description, prompt, model?, temperature?} |
| PUT | /api/agent-skills/[id] |
ááááá˘áᥠááá ááááŁáá áŁááá áᥠáááááŽáááá |
| DELETE | /api/agent-skills/[id] |
ááááá˘áᥠááá ááááŁáá áŁááá áᥠáŹáá¨áá |
| GET | /api/agent-skills/[id]/raw |
áááŁááŁá¨ááááááá prompt-ááĄá áá ááá˘ááááááŞáááááᥠáááŚááá (á¨ááĄá áŁááááᥠááá áá¨á) |
| POST | /api/agent-skills/generate |
ááŁáááá áá ááááá ááŚáŹáá áááááᥠáĄáá¤áŁáŤááááá ááŽááá áŁááá áᥠAI-áᥠááá¨áááááá ááááá áá ááá |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá áá ááá áááᥠscope-áᥠááĽááá API áááĄááŚááá.
ááá¨áᥠááá ááá
ááá ááá áĄááááá˘áááŁá á ááá¨á áá ááĄáŻáááááᥠááá¨á.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/cache |
ááá¨áᥠáááááŽáááá: áŠááááŹáá áááᥠáĄááá áá á áááááááá, áááááŽááááᥠáĄááŽá¨áá á, áááĄááá ááááááááŁáá áááá |
| GET | /api/cache/entries |
ááá¨áá áááŁáá áŠááááŹáá áááᥠáĄáá (áááá ááááá ááá§áá¤áá) |
| DELETE | /api/cache/entries |
ááá¨áᥠáŠááááŹáá áááᥠáŹáá¨áá (ááááŽááááᥠááá áááá˘á áááᥠáááŽááááá ááá¤ááá˘áá áá) |
| GET | /api/cache/stats |
ááá¨áᥠááá˘áááŁá á áĄá˘áá˘ááĄá˘ááá (ááááááŁáá áá ááááááá ááĄá áá áááááááĄááááĄ) |
| GET | /api/cache/reasoning |
ááĄáŻáááááᥠááá¨áᥠáĄá˘áá˘áŁáĄá (ááĄáŻáááááᥠáŽááááŽáá áááĄáá¨ááááá) |
| DELETE | /api/cache/reasoning |
ááĄáŻáááááᥠááá¨áᥠáááĄáŁá¤áááááá â ááááŽááááᥠááá áááá˘á ááá: ?toolCallId=<id> (áá áá), ?provider=<p> áá ááá áááá˘á áááᥠááá áá¨á (á§áááá) |
áááááá˘áá¤ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá.
áááŽáĄááá áááᥠáĄááĄá˘ááá
ááá ááá ááŁááááá áááŽáĄááá ááá (FTS5 + áááĽá˘áá áŁáá áŠáá¨ááááááá).
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/memory |
áááŽáĄááá áááᥠáŠááááŹáá áááᥠáĄáá (ááá¤ááá˘áá á áá áááááĄ, á˘ááááĄá áá áĄááŤáááá ááááŽááááᥠáááŽááááá) |
| POST | /api/memory |
áááŽáĄááá áááᥠááŽááá áŠááááŹáá áᥠá¨ááĽááá â áĄáŽááŁáá: {scope, type, content, metadata?} |
| GET | /api/memory/[id] |
áááŽáĄááá áááᥠááááá áá˘áŁáá áŠááááŹáá áᥠáááŚááá |
| PUT | /api/memory/[id] |
áááŽáĄááá áááᥠáŠááááŹáá áᥠáááááŽáááá |
| DELETE | /api/memory/[id] |
áááŽáĄááá áááᥠáŠááááŹáá áᥠáŹáá¨áá |
| GET | /api/memory?q= |
áááŽáĄááá áááá¨á áŤáááá (FTS5 + áááĽá˘áá á) â áĄá˘áá˘ááĄá˘ááá ááááá áááĄáŁáŽá¨áá áŠáá ááŁáá |
áááááá˘áá¤ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá áá ááá áááᥠáá ááááᥠááĽááá API áááĄááŚááá.
áááá°áŁáááá
ááá ááá áááááááááᥠáááá°áŁá-áááááŹáá ááá.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/webhooks |
á§áááá áááá°áŁá-áááááŹáá áᥠáĄáá |
| POST | /api/webhooks |
áááá°áŁá-áááááŹáá áᥠá¨ááĽááá â áĄáŽááŁáá: {url, events[], secret?, active?} |
| GET | /api/webhooks/[id] |
ááááá áá˘áŁáá áááá°áŁá-áááááŹáá áᥠáááŚááá |
| PUT | /api/webhooks/[id] |
áááá°áŁá-áááááŹáá áᥠáááááŽáááá |
| DELETE | /api/webhooks/[id] |
áááá°áŁá-áááááŹáá áᥠáŹáá¨áá |
| GET | /api/webhooks/[id]/deliveries |
áááá°áŁááᥠáááŹáááááááᥠááĄá˘áá ááᥠáĄáá (áŹáá ááá˘ááá/áŹáá áŁááá˘ááááááᥠááŁá áááá) |
| POST | /api/webhooks/[id]/test |
áááá°áŁáááĄáááᥠáĄáá˘ááĄá˘á áááááááᥠáááááááá |
áááááá˘áá¤ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá.
áááááááááᥠá˘áááááᥠáĄá áŁáá áĄáááĄáááᥠááŽáááá áááá°áŁááááᥠá¤á áááááá áá.
áŁááá áááᥠá¤á áááááá áá
ááá ááá áŁááá ááá (ááááá˘áŁá á ááá¤áá áááááááᥠá¤á áááááá áá).
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/skills |
á§áááá áááááĄá˘áááá áááŁáá áŁááá áᥠáĄáá (áŠáá¨áááááŁáá + ááá ááááŁáá) |
| POST | /api/skills/install |
áŁááá áᥠáááááĄá˘áááá ááá ááááááŁá á áááááá áá URL-ááá |
| DELETE | /api/skills/[id] |
áŁááá áᥠáááááĄá˘ááááŞáá |
| PUT | /api/skills/[id] |
áŁááá áᥠáŠáá ááá áá ááááá ááá â ááááŽááááᥠáĄáŽááŁáá: {enabled?: boolean, mode?: "on" | "off" | "auto"} |
| POST | /api/skills/executions |
áŁááá áᥠá¨ááĄá áŁáááá â ááááŽááááᥠáĄáŽááŁáá: {skillName, apiKeyId, input?, sessionId?} |
| GET | /api/skills/executions |
á§áááá áŁááá áᥠá¨ááĄá áŁááááᥠááĄá˘áá ááᥠáĄáá (ááá¤ááá˘á áá ?apiKeyId=-áá) |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá áá ááá áááᥠáááĄá¨á˘áááᥠAPI áááĄááŚááá.
áĄá áŁáá ááá˘ááááááĄáááᥠááŽáááá áŁááá áááᥠá¤á áááááá áá.
ááááááááá
ááá ááá OmniRoute-áᥠááááááááá (áááĄááá ááŽáá áᥠááá¤áá ááááááá).
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/plugins |
áááááĄá˘áááá áááŁáá áááááááááᥠáĄáá |
| POST | /api/plugins/marketplace/install |
áááááááᥠáááááĄá˘áááá ááá ááá ááá˘áááááĄáááá |
| DELETE | /api/plugins/[name] |
áááááááᥠáááááĄá˘ááááŞáá |
| POST | /api/plugins/[name]/activate |
áááááááᥠááááĽá˘ááŁá ááá |
| POST | /api/plugins/[name]/deactivate |
áááááááᥠááááĽá˘ááááŞáá |
| GET | /api/plugins/[name]/config |
áááááááᥠáááá¤áááŁá ááŞááᥠáááŚááá |
| PUT | /api/plugins/[name]/config |
áááááááᥠáááá¤áááŁá ááŞááᥠáááááŽáááá |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá.
áĄá áŁáá ááá˘ááááááĄáááᥠááŽáááá áááááááááᥠá¤á áááááá áá.
áŠá áááááááá ááá á¨á áŁá˘ááááŞáá
áá ááááááá áááᥠáŠá áááááááá / A-B á¨áááá ááá áá áá áᥠáááááŁáááááááá REST ááá˘áá á¤áááĄá â áᥠáááá¤áááŁá áá áááá áááááááá áááŁáá ááá á¨á áŁá˘ááááŞááᥠááá¨áááááá (ááŽáááá ááá˘áááááá). ááááááŁáá áááááᥠá¨áááá áááᥠááá˘á ááááá áŽáááááĄááŹáááááá GET /api/combos/metrics-áᥠááá¨áááááá.
ááááŞááá áááĽáááááááá
á¨áááááŹááá á¨ááĄá áŁááááᥠááá áááᥠááááŞááá áááĽáááááááá (PII-áᥠááááááááá, áá áááá˘-ááááĽáŞááᥠááááááááá, áŽááááᥠáááááááááá áááááá¨áá ááá). ááááŞááá áááĽáááááááá áĄá áŁááááá á§áááá ááááŽáááááá; ááááááŁáá áááááŤááŽááááĄáááᥠáááá ááááá˘ááááá á¨ááĄááŤááááááá ááááŽááááᥠx-omniroute-disabled-guardrails áĄááááŁá áᥠááá¨áááááá â ááŁááááá áŠáá ááááĄ/ááááá áááᥠááá˘áá á¤áááĄá áá áá áĄáááááĄ.
| áááááá | ááá | ááŚáŹáá á |
|---|---|---|
| GET | /api/guardrails |
á ááááĄá˘á áá áááŁáá ááááŞááá áááĽáááááááááĄá áá áááá áĄá˘áá˘áŁáĄáᥠáĄáá (áĄááŽááá / áŠáá ááŁááá áᣠáá á / áá ááá áá˘áá˘á) |
| POST | /api/guardrails/test |
áááááŤááŽáááááá áááĽáááá áááááááá áᥠáĄáá˘ááĄá˘á ááá¨áááá ááááŁá¨áŁá á¨áá§áááááá â ááááŽááááᥠáĄáŽááŁáá: {input, disabledGuardrails?} |
ááá˘áá ááááŞáá: áĄáááá áá ááá áááᥠáĄááĄáá.
áĄá áŁáá ááá˘ááááááĄáááᥠááŽáááá áŁáĄáá¤á ááŽáááá > ááááŞááá áááĽáááááááá.
áááááá˘áá¤ááááŞáá
áááŽá á˘áááᥠááá˘áá ááááŞááᥠáááááŞáááááᥠ(ááá áááᥠááááááᥠáĄááĄáá, ááááááŁá á CLI á˘ááááá, oma_live_⌠áŹáááááᥠá˘ááááá, ááá áááᥠáŁá¤ááááááá á¨áááŚáŁááŁáá API áááĄááŚááá) áá áááá ááá¤áá áááŞááᥠáááĄááŚááááááĄááá ááááĄáŽááááááááᥠá¨ááĄááŽáá ááŽáááá ááá áááᥠáááááá˘áá¤ááááŞáá.
- ááá áááᥠááááááᥠááá á¨á áŁá˘ááá (
/dashboard/*) áá§áááááĄauth_tokencookie-ᥠ- á¨ááĄááááĄáᥠáááááá§ááááá á¨ááááŽáŁáá ááá áááᥠá°áá¨á; áĄáá áááá áá ááá áááá˘áá
INITIAL_PASSWORD requireLogin-áᥠááááá ááá á¨ááĄááŤááááááá/api/settings/require-login-áᥠááá¨ááááááREQUIRE_API_KEY=true-áᥠá¨ááááŽááááá¨á,/v1/*ááá á¨á áŁá˘áááá á¨ááĄááŤááá Bearer API áááĄááŚááá áááááŽááááĄ- áá áŞááááá á¨á âááá áááᥠá˘áááááâ / âááá áááᥠáŁá¤ááááááá á¨áááŚáŁááŁáá API áááĄááŚáááâ ááŁáááĄáŽáááᥠááŚááá¨ááŁá áĄááŽááááŤáŚááááááá¨á ááŚáŹáá ááá á˘áááááááá áá á-áá áᥠáá áá á ááááá˘áááá, ááááŁáĄáááŚáá áá áĄááááŁááá áááááŞáááá á˘áááĄ
áŁááŁááááĄáááááááᥠáááá áŚáááá áŞááááááá (v3.8.0) â
/api/v1/agents/tasks/*áá ááá§ááááááᥠááá ááááᥠááá áááᥠáĄáááááá áŹáá á˘ááááá ááŽáá ááá áááᥠáááááá˘áá¤ááááŞááᥠáááááŽááᥠ(ááá áááᥠáááááááĄauth_tokencookie áá ááá áááᥠáŁá¤ááááááá á¨áááŚáŁááŁáá API áááĄááŚááá). áááááá˘ááá, á áááááá᪠ááá á áá ááá á¨á áŁá˘ááᥠáááááá˘áá¤ááááŞááᥠááá áá¨á ááŤááŽáááááá, ááááŚáááá áááĄáŁáŽáĄ401 Unauthorized. ááŽáááá ááááá˘á588a0333(fix(auth): ááááá˘ááĄá áá ááá§ááááááᥠááá ááááᥠAPI-ááááĄáááᥠááá áááᥠáááááá˘áá¤ááááŞááᥠááááŽáááá).