Raw unstructured text files
AI Models & Assistants / Knowledge library
text-embedding-3-small
Small embedding model
Why learn text-embedding-3-small?
Offers the documented OpenAI model capabilities through hosted.
The problem it solves
Provides model inference for supported text inputs.
Where it came from
text-embedding-3-small: Small embedding model Published aliases: text-embedding-3-small. Input: text. Output: text. Checked 2026-10-13. Model capabilities are distinct from tools available in a particular agent.
Build your understanding
Work through these exercises in order. Try the task before opening a reference.
- Explain what text-embedding-3-small does.
- Identify a use case for text-embedding-3-small.
- Describe a limitation of text-embedding-3-small.
- Name a compatible tool for text-embedding-3-small.
- Compare text-embedding-3-small against an alternative.
Documentation and sources
- Primary source / model card (developers.openai.com)
Catalog research notes
- See the AI Workbench for source dates, pricing evidence and configuration details.
Connect the ideas
Built on
Real World Example
Optimizing Internal Knowledge Retrieval for Global Logistics
A global logistics firm managing thousands of unstructured shipping manifests, regulatory documents, and internal process manuals.
The business problem
Employees struggle to locate specific compliance procedures within a massive, growing repository of text-heavy documents, leading to operational delays and inconsistent adherence to regional shipping regulations.
How this topic solves it
The firm implements text-embedding-3-small to convert diverse internal documents into high-dimensional vector representations. By indexing these embeddings in a vector database, the system enables semantic search, allowing employees to query for concepts like 'hazardous material handling in EU ports' rather than relying on exact keyword matches.
- Pre-process and chunk internal documents into manageable text segments.
- Send text chunks to the v1/embeddings endpoint using the text-embedding-3-small model.
- Store the resulting numerical vector arrays in a vector-capable database.
- Convert user search queries into embeddings using the same model.
- Perform a cosine similarity search to retrieve the most relevant document chunks for the user.
This diagram illustrates the flow from raw text to semantic retrieval.
text-embedding-3-small
Storage for numerical embeddings
Natural language input
Similarity search results
- Document Repository → vectorizes text → Embedding API
- Embedding API → stores vectors → Vector Database
- User Query → embeds query → Embedding API
- Vector Database → compares similarity → Retrieval Engine
Implementation example
This code demonstrates calling the v1/embeddings endpoint to transform a text string into a vector, which is the core requirement for the semantic search solution.
import openai
# Generate embeddings for a document chunk
response = openai.Embedding.create(
input="EU port hazardous material protocol",
model="text-embedding-3-small" # Specify the model ID
)
vector = response['data'][0]['embedding'] # Extract the numerical representationExpected business outcome
Employees experience a significant reduction in time spent searching for information, as the system surfaces contextually relevant documents even when the user's terminology differs from the source text.
Limitations and checks
The model produces fixed-length vector representations. A primary limitation is that while these embeddings capture semantic meaning, they do not inherently understand complex logical reasoning or multi-step document synthesis. To verify if the model is sufficient for a specific use case, developers should perform an evaluation using a golden dataset of query-document pairs to measure retrieval precision.