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
- 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.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseModelParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| strict_response_format | boolean | false | yes | — |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| endpoint | string | https://api.openai.com/v1 | no | — |
Output contract
Values this component publishes to consumers over the uses topology.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| endpoint | string | — | yes | Base 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. |
| model | string | — | yes | Name 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
- $refextends schema (values)
BaseComponents#/schemas/BaseModelParameter
Used by
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «model»
uses socket «target_model»
uses socket «extraction_model»
uses socket «embedding_model»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «models»
uses socket «content_safety»
implements
implements