Catalogue / Compute

AI service

computeai-service

A consumption API for hosted models: text, vision, speech or multimodal.

Category
Compute
Properties
13
Components
126
Rules
2
Properties · 13 defined by this kind

A node of this kind resolves each property from its own props, then the component's defaults, then the default below.

propertytypevaluesrequireddefault
authenumapi-key | oauth | iam | noneno—
contentFilteringboolean—no—
customerManagedKeysboolean—no—
dataResidency · advancedenumus | eu | asia | globalno—
dataRetentionDaysinteger—no—
keyStoreboolean—nofalse
managedboolean—nofalse
modalityenumtext | vision | speech | multimodal | structured | image | video | audio | embedding | rerankno—
publicEndpointboolean—no—
quotaUnitsPerMinuteinteger—no—
rateLimitRpm · advancedinteger—no—
rateLimitTpm · advancedinteger—no—
viaGatewayboolean—nofalse
Rules for this kind · 2
ai-api-key-unmanaged

This AI vendor is reached with an API key, and nothing in the design holds or rotates that key. It ends up in environment files or code, every caller shares it, and a single leak runs up the vendor bill until someone notices. Put the key in a key-management component, or say it is held there with keyStore.

  • — all of these hold:
  • — the node's `auth` is "api-key"
  • — the node's `keyStore` is false
  • — the node has at least one incoming edge from an app-server, worker or client
  • — this does not hold:
  • — the design contains a node of kind key-management
stateful-node-without-zone-redundancy

A stateful compute node pinned to exactly one availability zone disappears with that zone, and its state goes with it. Nodes inside a cell are exempt, because there the cell is deliberately single-zone and redundancy comes from the other cells.

  • — all of these hold:
  • — the node's `stateless` is false
  • — the node sits inside exactly 1 availability-zone group
  • — this does not hold:
  • — the node sits inside at least one cell group
Components · 126
default
AI21 APIai21-api5 defaultsAleph Alpha APIaleph-alpha-api2 defaultsAnthropic APIanthropic-api6 defaultsAssemblyAIassemblyai5 defaultsBaidu Qianfanbaidu-ernie-api6 defaultsBlack Forest Labs APIblack-forest-labs-api5 defaultsBland AIbland-ai4 defaultsCartesiacartesia4 defaultsCerebras Inferencecerebras-api6 defaultsCohere APIcohere-api6 defaultsDeepgramdeepgram4 defaultsDeepInfradeepinfra5 defaultsDeepSeek APIdeepseek-api5 defaultsElevenLabselevenlabs4 defaultsfalfal-ai5 defaultsFireworks AIfireworks-ai4 defaultsGitHub Modelsgithub-models4 defaultsGladiagladia4 defaultsGroqgroq5 defaultsHume AIhume-ai4 defaultsIdeogram APIideogram-api4 defaultsJina AIjina-ai6 defaultsLepton AIlepton-ai4 defaultsLuma Dream Machine APIluma-api5 defaultsMiniMax APIminimax-api6 defaultsMistral AI APImistral-api5 defaultsMixedbreadmixedbread-ai5 defaultsKimi Open Platformmoonshot-kimi-api6 defaultsNomic APInomic-api4 defaultsNovita AInovita-ai4 defaultsNVIDIA API Catalognvidia-nim-api4 defaultsOpenAI APIopenai-api6 defaultsOpenRouteropenrouter5 defaultsPerplexity APIperplexity-api5 defaultsPlayHTplayht4 defaultsRecombeerecombee4 defaultsReka APIreka-api4 defaultsReplicatereplicate4 defaultsRetell AIretell-ai4 defaultsRev AIrev-ai5 defaultsRimerime4 defaultsRunway APIrunway-api4 defaultsSambaNova Cloudsambanova-api5 defaultsSpeechmaticsspeechmatics4 defaultsStability AI APIstability-ai-api5 defaultsSynthflowsynthflow4 defaultsTogether AItogether-ai5 defaultsVapivapi4 defaultsVoyage AIvoyage-ai4 defaultsWriter APIwriter-api7 defaultsxAI APIxai-api6 defaultsZ.ai Open Platformzhipu-glm-api4 defaults
Source
# yaml-language-server: $schema=../schema/kind.schema.json
# A metered vendor endpoint with quota, content filtering and data-handling settings, unlike ml-inference which is a model you deploy on replicas you size. contentFiltering, publicEndpoint, dataRetentionDays and auth have no default so governance rules can catch what was never declared; keyStore and viaGateway say whether the key sits in a key-management component and whether calls pass an AI gateway.
schemaVersion: "1"
type: "kind"
id: "ai-service"
category: "compute"
properties:
  modality:
    type: "enum"
    values: ["text", "vision", "speech", "multimodal", "structured", "image", "video", "audio", "embedding", "rerank"]
  contentFiltering:
    type: "boolean"
  publicEndpoint:
    type: "boolean"
  dataRetentionDays:
    type: "integer"
  customerManagedKeys:
    type: "boolean"
  quotaUnitsPerMinute:
    type: "integer"
  auth:
    type: "enum"
    values: ["api-key", "oauth", "iam", "none"]
  keyStore:
    type: "boolean"
    default: false
  viaGateway:
    type: "boolean"
    default: false
  rateLimitRpm:
    type: "integer"
    advanced: true
  rateLimitTpm:
    type: "integer"
    advanced: true
  dataResidency:
    type: "enum"
    values: ["us", "eu", "asia", "global"]
    advanced: true
  managed:
    type: "boolean"
    default: false

The same page as markdown, for an agent: /catalogue/kinds/ai-service.md