Skip to main content

init_embeddings

def init_embeddings(
    model: str,
    *,
    provider: str | None = None,
    **kwargs: Any,
) -> Embeddings
Initialize an embedding model from a model name and optional provider.
Requires the integration package for the chosen model provider to be installed (e.g., pip install langchain-openai).Refer to the provider integration’s API reference for supported model parameters to use as **kwargs.
model
str
required
The name of the model, e.g. 'openai:text-embedding-3-small'.You can also specify model and model provider in a single argument using '{model_provider}:{model}' format, e.g. 'openai:text-embedding-3-small'.
provider
str | None
The model provider if not specified as part of the model arg (see above).Supported provider values and the corresponding integration package are:
**kwargs
Any
Additional model-specific parameters passed to the embedding model.These vary by provider. Refer to the specific model provider’s integration reference for all available parameters.
returns
Embeddings
An Embeddings instance that can generate embeddings for text.

Examples

# pip install langchain langchain-openai

# Using a model string
model = init_embeddings("openai:text-embedding-3-small")
model.embed_query("Hello, world!")

# Using explicit provider
model = init_embeddings(model="text-embedding-3-small", provider="openai")
model.embed_documents(["Hello, world!", "Goodbye, world!"])

# With additional parameters
model = init_embeddings("openai:text-embedding-3-small", api_key="sk-...")
Added in langchain 0.3.9

Embeddings

from langchain_core.embeddings import Embeddings
The base class for all embedding models in LangChain. This is re-exported from langchain_core for convenience. See the LangChain Core documentation for the full API reference.
With the release of langchain 1.0.0, several embeddings modules were moved to langchain-classic, such as CacheBackedEmbeddings and all community embeddings.See the list of moved modules to inform your migration.

Build docs developers (and LLMs) love