Component

core/ai-model/openai

OpenAI's managed chat-completions API, reached as an external reference: no compute runs in-cluster and the compiler never calls the provider. It is realized as a direct reference — on Kubernetes an ExternalName Service mapping an in-cluster name onto the managed host, on Compose the endpoint carried to consumers with no service run — which delivers no credential: a consumer that needs the key presents it from the connection it reaches the model on. The endpoint defaults to the managed API's base URL, version path included, so a bare declaration is enough, and it sits on `infra` rather than inside a Recipe so an operator may repoint it at a gateway or proxy without editing the Aggregate. Consumers read the endpoint and the model name over a `uses` edge — the contract every model here publishes — so an agent reaches it with no endpoint in its own code. A gateway reaches it the same way, wired to the gateway's models socket with the key on that connection, so the gateway holds the key and an application behind the gateway never sees it.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:ab8f3aa462a32bf11e55690e436b4ebe8382290a16b68cc3c38e394b0a44d98f
Published
2026-11-10T10:09:32Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:34c2212198aab02885eb9427ce21188f64fb0f00e13cdd68e931db3bfc8719ba

Reference at this version

oci://hub.aggrega.ai/component/core/ai-model/openai:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseModelParameter

NameTypeDefaultRequiredDescription
strict_response_formatbooleanfalseyes—

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
endpointstringhttps://api.openai.com/v1no—

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
endpointstring—yesBase URL a consumer sends chat-completion requests to, version path included, so a client appends only the route. It is the endpoint set in the Release — the managed API's base URL by default, or the gateway or proxy an operator repoints it at — with no change to the application.
modelstring—yesName of the model a request asks for, carried through from the model the Aggregate declared. A consumer sends it as the model field of each request.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

No self-inject pipes declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy