Component

core/ai-model/openai-embedding

OpenAI's managed embeddings API, reached as an external reference: no compute runs in-cluster and the compiler never calls the provider. It publishes the same endpoint-and-model contract the generative models publish, so an application that embeds text reads exactly the keys it would read to generate it, and the output width is a declared value where an Aggregate wants vectors narrower than the model's own default. The endpoint defaults to the managed API's base URL, version path included, and sits on `infra`, so a bare declaration is enough and an operator may still repoint it at a gateway or proxy. The API key is the consumer's to attach: the environment-variable name it arrives under belongs to the application rather than to the model.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:fef3da9cae6160effadfa1f1f1c40c19a02ebbda2763014980edd2317abd433c
Published
2026-11-10T10:09:31Z
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:8c516362c4a154b3b0ae3303d06c4e7e7824153894de3d13eb96478f047b9649

Reference at this version

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

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseModelParameter

NameTypeDefaultRequiredDescription
dimensionsinteger—no—

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 embedding requests to, version path included, so a client appends only the route. It follows the endpoint set in the Release, so an operator may point it elsewhere without the application changing.
modelstring—yesName of the embedding 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