Sdg1
Source
- Canonical Cookbook page: https://developers.openai.com/cookbook/examples/sdg1
- OpenAI Cookbook source: https://github.com/openai/openai-cookbook/blob/main/examples/SDG1.ipynb
- Raw source: https://raw.githubusercontent.com/openai/openai-cookbook/main/examples/SDG1.ipynb
- Source path:
examples/SDG1.ipynb - Source kind:
examples - Source format:
.ipynb - License basis: OpenAI Cookbook repository MIT license.
- Content hash:
3a4bd9559bad9a5e6367eea6222663c7b483e8495e174562d9370ee70fb4c794
Classification
- Primary category: General OpenAI API patterns
- Wiki collection: 2026-05-15-openai-cookbook
- Taxonomy page: openai-cookbook-taxonomy
- Topic hub: openai-cookbook
Summary
Synthetic Data generation (Part 1) Synthetic data generation using large language models (LLMs) offers a powerful solution to a commonly faced problem: the availability of high-quality, diverse, and privacy-compliant data. This could be used in a number of scenarios such as training a data science machine learning model (SVMs, decision trees, KNN’s), finetun…
What This Teaches
- A concrete OpenAI implementation pattern in the category: General OpenAI API patterns.
Implementation Use Cases
- Use as a concrete implementation reference when building OpenAI API systems in this category.
- Compare against current official API docs before copying model names, SDK calls, or parameters into production code.
- Preserve this page as a mirrored source; prefer synthesis pages for personal recommendations or project-specific decisions.
Mirrored Content
Synthetic Data generation (Part 1)
Synthetic data generation using large language models (LLMs) offers a powerful solution to a commonly faced problem: the availability of high-quality, diverse, and privacy-compliant data. This could be used in a number of scenarios such as training a data science machine learning model (SVMs, decision trees, KNN’s), finetuning a different GPT model on the data, as a solution to the coldstart problem, helping build compelling demos/apps with realistic data, scenario testing etc.
There are a number of key drivers which may see you wanting to leverage synthetic data.
- Human data may have privacy restrictions and/or identifiable data within it which we do not want to be used.
- Synthetic data can be much more structured and therefore easier to manipulate than real data.
- In domains where data is sparse or data of certain categories is sparse we may want to augment the data.
- When dealing with imbalanced datasets or datasets which lack diversity, we may want to create data to improve the richness of our datasets.
Unlike traditional data augmentation or manual data creation methods, using LLMs allows for the generation of rich, nuanced, and contextually relevant datasets that can significantly enhance it’s usefulness to enterprises and developers.
We split this tutorial into 2 parts. In this cookbook, we will have the following agenda:
- CSV with a structured prompt
- CSV with a Python program
- Multitable CSV with a python program
- Simply creating textual data
- Dealing with imbalanced or non-diverse textual data while in part 2, we will look at prompting strategies for getting better textual data.
The last two in particular are useful for creating synthetic data to finetune another GPT model. For example using higher quality data produced by gpt-4o to finetune the cheaper and quicker gpt-3.5-turbo for improved performance while reducing costs.
Getting setup
%pip install openai
%pip install pandas
%pip install scikit-learn
%pip install matplotlibfrom openai import OpenAI
import os
import re
import numpy as np
import pandas as pd
from sklearn.cluster import KMeans
import matplotlib.pyplot as plt
import json
import matplotlib
client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY", "<your OpenAI API key if not set as env var>"))1. CSV with a structure prompt
Here we create data in the simplest way. You can quickly generate data by addressing 3 key points: telling it the format of the data (CSV), the schema, and useful information regarding how columns relate (the LLM will be able to deduce this from the column names but a helping hand will improve performance).
datagen_model = "gpt-4o-mini"
question = """
Create a CSV file with 10 rows of housing data.
Each row should include the following fields:
- id (incrementing integer starting at 1)
- house size (m^2)
- house price
- location
- number of bedrooms
Make sure that the numbers make sense (i.e. more rooms is usually bigger size, more expensive locations increase price. more size is usually higher price etc. make sure all the numbers make sense). Also only respond with the CSV.
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
print(res)2. CSV with a Python program
The issue with generating data directly is we are limited in the amount of data we can generate because of the context. Instead what we can do is ask the LLM to generate a python program to generate the synthetic data. This allows us to scale to much more data while also providing us a view into how the data was generated by inspecting the python program.
This would then let us edit the python program as we desire while giving us a good basis to start from.
question = """
Create a Python program to generate 100 rows of housing data.
I want you to at the end of it output a pandas dataframe with 100 rows of data.
Each row should include the following fields:
- id (incrementing integer starting at 1)
- house size (m^2)
- house price
- location
- number of bedrooms
Make sure that the numbers make sense (i.e. more rooms is usually bigger size, more expensive locations increase price. more size is usually higher price etc. make sure all the numbers make sense).
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
print(res)We need to make sure to parse the output of this appropriately as often there may be surrounding text to the python code. We can also explicitly ask it to state all assumptions it made about the data it’s generating, however in this circumstance it told us that automatically.
3. Multitable CSV with a python program
For more complex relationships however we need to make sure to specify a few more characteristics.
To create multiple different datasets which relate to each other (for example housing, location, house type), as before we would need to specify the format, schema and useful information. However, the useful information required to get good performance is higher now. It’s case-specific but a good amount of things to describe would be how the datasets relate to each other, addressing the size of the datasets in relation to one another, making sure foreign and primary keys are made appropriately and ideally using previously generated datasets to populate new ones so the actual data values match where necessary.
question = """
Create a Python program to generate 3 different pandas dataframes.
1. Housing data
I want 100 rows. Each row should include the following fields:
- id (incrementing integer starting at 1)
- house size (m^2)
- house price
- location
- number of bedrooms
- house type
+ any relevant foreign keys
2. Location
Each row should include the following fields:
- id (incrementing integer starting at 1)
- country
- city
- population
- area (m^2)
+ any relevant foreign keys
3. House types
- id (incrementing integer starting at 1)
- house type
- average house type price
- number of houses
+ any relevant foreign keys
Make sure that the numbers make sense (i.e. more rooms is usually bigger size, more expensive locations increase price. more size is usually higher price etc. make sure all the numbers make sense).
Make sure that the dataframe generally follow common sense checks, e.g. the size of the dataframes make sense in comparison with one another.
Make sure the foreign keys match up and you can use previously generated dataframes when creating each consecutive dataframes.
You can use the previously generated dataframe to generate the next dataframe.
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
print(res)4. Simply creating textual data
Here we take a first look at creating textual data. This can be used to finetune another GPT model for example. In this case we imagine ourselves a retailer trying to streamline the process of creating descriptions for items they are selling. We again need to specify the format of the data, in particular in this case we want one which is easy to parse as an output.
The example we consider below is one in which we want to create input output training pairs for GPT model to finetune on. We will have the products’ name and the category it belongs to as input and the output will be a description.
Specifying the structure of the output explicitly and giving commands to not deviate from this help enforce the output structure. You can run this in a loop and append the data to generate more synthetic data. Again, as before we will need to parse the data well so that our code further downstream does not break.
output_string = ""
for i in range(3):
question = f"""
I am creating input output training pairs to fine tune my gpt model. The usecase is a retailer generating a description for a product from a product catalogue. I want the input to be product name and category (to which the product belongs to) and output to be description.
The format should be of the form:
1.
Input: product_name, category
Output: description
2.
Input: product_name, category
Output: description
Do not add any extra characters around that formatting as it will make the output parsing break.
Create as many training pairs as possible.
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
output_string += res + "\n" + "\n"
print(output_string[:1000]) #displaying truncated responseNote: the above output is truncated. And now we can parse it as below to get a list of products, categories and their descriptions. For example, let’s take a look at the products it’s generated.
#regex to parse data
pattern = re.compile(r'Input:\s*(.+?),\s*(.+?)\nOutput:\s*(.+?)(?=\n\n|\Z)', re.DOTALL)
matches = pattern.findall(output_string)
products = []
categories = []
descriptions = []
for match in matches:
product, category, description = match
products.append(product.strip())
categories.append(category.strip())
descriptions.append(description.strip())
products5. Dealing with imbalanced or non-diverse textual data
Some of the most important aspects of generating high-quality synthetic data are accuracy (does the data make sense), consistency (are two separate data points for the same input roughly the same) and diversity (making sure our data distribution matches as much of the distribution that exists in production).
To increase the diversity of our data, we start first by clustering the data. This will provide us information about which clusters are underrepresented (imbalanced dataset) or which data is not addressed at all (widening the data distribution). Then, we will either suggest new clusters (using self-reflection type call from GPT) or ask the next iteration of our synthetic generation calls to explicitly target the underrepresented clusters.
We can then recursively run this generation and analysis of cluster loop to automate generating diverse synthetic data.
For demonstrative purposes, we explicitly prompt the LLM to generate information about 4 different topical areas: vehicle, clothing, toiletries, food. We will then cluster the data and see if it managed to find these 4 topic areas.
output_string = ""
for i in range(3):
question = f"""
I am creating input output training pairs to fine tune my gpt model. I want the input to be product name and category and output to be description. the category should be things like: mobile phones, shoes, headphones, laptop, electronic toothbrush, etc. and also more importantly the categories should come under 4 main topics: vehicle, clothing, toiletries, food)
After the number of each example also state the topic area. The format should be of the form:
1. topic_area
Input: product_name, category
Output: description
Do not add any extra characters around that formatting as it will make the output parsing break.
Here are some helpful examples so you get the style of output correct.
1) clothing
Input: "Shoe Name, Shoes"
Output: "Experience unparalleled comfort. These shoes feature a blend of modern style and the traditional superior cushioning, perfect for those always on the move."
"""
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
output_string += res + "\n" + "\n"
print(output_string[:1000]) #displaying truncated responseNote: The above output is truncated. In the example above, we would explicitly include the topic area as part of the response per example as it helps condition the proceeding output and tends to give better performance. We can also give it an actual example of what the output should look like so it gets the right idea of style of output but also to help enforce structure.
pattern = re.compile(r'(\d+)\.\s*(\w+)\s*Input:\s*"(.+?),\s*(.+?)"\s*Output:\s*"(.*?)"', re.DOTALL)
matches = pattern.findall(output_string)
topics = []
products = []
categories = []
descriptions = []
for match in matches:
number, topic, product, category, description = match
topics.append(topic)
products.append(product)
categories.append(category)
descriptions.append(description)productsWe will now cluster the data to analyze it. We will use K-means clustering to segregate the data. An important parameter of K-means to set is K, the number of clusters.
We know that there should be 4 cluster (4 topics) since we specified this in prompt: vehicle, electronics, clothing, food. However in general for our data, we do not know the number of clusters that exist. Therefore we will use the elbow method to find the optimal number of clusters.
In the elbow method, we iterate through a range of different K’s, each time storing the inertia. The inertia measures the sum of the squared distances between each point in a cluster and the centroid of that cluster thus telling us how well-separated and dense each cluster is. If we plot K against the inertia, we are able to see how the inertia drops and where the drop in inertia is least rapid (often making an elbow shape) we can set our optimal number of clusters. You can read into more depth about the elbow method here.
First let’s store our data into a pandas dataframe for ease of analysis
data = {
'Product': products,
'Category': categories,
'Description': descriptions
}
df = pd.DataFrame(data)Next let us embed our data as the embeddings is what we will cluster since they should be close to each other in vector space if they are similar.
def get_embedding(text, model="text-embedding-3-small"):
text = text.replace("\n", " ")
response = client.embeddings.create(input=[text], model=model)
return response.data[0].embedding
embedding_model = "text-embedding-3-small"
df["embedding"] = df.Category.apply(lambda x: get_embedding(x, model=embedding_model))
# Ensure there are embeddings to concatenate
if len(df.embedding.values) > 0:
matrix = np.vstack(df.embedding.values)
else:
matrix = np.array([]) # Handle the case where there are no embeddingsdfNow we perform the elbow method.
# Determine the optimal number of clusters using the elbow method
inertias = []
range_of_clusters = range(1, 13) # Adjust the range as necessary
for n_clusters in range_of_clusters:
kmeans = KMeans(n_clusters=n_clusters, init="k-means++", random_state=42, n_init=10)
kmeans.fit(matrix)
inertias.append(kmeans.inertia_)This will output a chart for us in which we have to visually tell where the optimal cluster point is. We can see below that we see a gradual decrease of inertia rather than a sharp elbow but the point of steepest decrease appears to occur around 3, 4 or 5 clusters which lines up with our expectations given our prompt.
# Plotting the elbow plot
plt.figure(figsize=(10, 6))
plt.plot(range_of_clusters, inertias, '-o')
plt.title('Elbow Method to Determine Optimal Number of Clusters')
plt.xlabel('Number of Clusters')
plt.ylabel('Inertia')
plt.xticks(range_of_clusters)
plt.show()
For demonstration purposes we will pick 5 as the optimal cluster number to show it doesn’t matter exactly where we pick it as long as we are approximately right. There are numerous correct ways to categorize data. We also store which cluster each data point belongs to.
n_clusters = 5
kmeans = KMeans(n_clusters=n_clusters, init="k-means++", random_state=42)
kmeans.fit(matrix)
labels = kmeans.labels_
df["Cluster"] = labelsWe will analyze the cluster data now. There are two separate things we will look to address. 1. imbalanced data, 2. Expanding the data distribution.
First for imbalanced data we count the number of examples in each cluster. Then we select a few examples from each cluster at random and ask the LLM what topics these map to.
cluster_counts = df["Cluster"].value_counts().sort_index()
print(cluster_counts)We can see the topics found here: Eco-friendly Transportation, Luxury and Leisure Items, Personal Care Products, Electronic Toothbrushes and Clothing and Apparel match well enough but not exactly to our initial prompt of: vehicle, clothing, toiletries, food.
As we chose 5 clusters, it split up toiletries into Skincare and Personal Care which doesn’t affect us too much further downstream.
dfselected_examples = df.groupby('Cluster').apply(lambda x: x.sample(3, replace=True)).reset_index(drop=True)
# Format the selected examples
formatted_examples = "\n".join(
f'Input: "{row["Product"]}, {row["Category"]}"\nOutput: "{row["Description"]}"\nCluster: "{row["Cluster"]}"'
for _, row in selected_examples.iterrows()
)
topic_prompt = f"""
I previously generated some examples of input output trainings pairs and then I clustered them based on category. From each cluster I picked 3 example data point which you can find below.
I want you identify the broad topic areas these clusters belong to.
Previous examples:
{formatted_examples}
Your output should be strictly of the format:
Cluster: number, topic: topic
Cluster: number, topic: topic
Cluster: number, topic: topic
Do not add any extra characters around that formatting as it will make the output parsing break.
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed analyze clustered data"},
{"role": "user", "content": topic_prompt}
]
)
res = response.choices[0].message.content
pattern = r"Cluster: (\d+), topic: ([^\n]+)"
matches = re.findall(pattern, res)
clusters = [{"cluster": int(cluster), "topic": topic} for cluster, topic in matches]
json_output = json.dumps(clusters, indent=2)
print(json_output)We now have the clusters and their counts so we could prompt the LLM to generate more examples within the topics we want. However for this example we won’t take that further as they are well-split and you would just follow the procedure above for prompting the model to generate data while passing in the underrepresented topics.
Next, we will try and deal with increasing the diversity of our data distribution.
First we start in a similar way by finding a few examples from each cluster at random and ask the LLM what topics these map to. In addition to this in the same LLM call, we will ask it to generate more topics to increase the diversity of our data. We do this in one call to save time/cost.
selected_examples = df.groupby('Cluster').apply(lambda x: x.sample(3, replace=True)).reset_index(drop=True)
# Format the selected examples
formatted_examples = "\n".join(
f'Input: "{row["Product"]}, {row["Category"]}"\nOutput: "{row["Description"]}"\nCluster: "{row["Cluster"]}"'
for _, row in selected_examples.iterrows()
)
topic_prompt = f"""
I previously generated some examples of input output trainings pairs and then I clustered them based on category. From each cluster I picked 3 example data point which you can find below.
I want to promote diversity in my examples across categories so follow the procedure below:
1. You must identify the broad topic areas these clusters belong to.
2. You should generate further topic areas which don't exist so I can generate data within these topics to improve diversity.
Previous examples:
{formatted_examples}
Your output should be strictly of the format:
1. Cluster topic mapping
Cluster: number, topic: topic
Cluster: number, topic: topic
Cluster: number, topic: topic
2. New topics
1. topic
2. topic
3. topic
4. topic
Do not add any extra characters around that formatting as it will make the output parsing break. It is very important you stick to that output format
"""
response = client.chat.completions.create(
model=datagen_model,
messages=[
{"role": "system", "content": "You are a helpful assistant designed to analyze clustered data"},
{"role": "user", "content": topic_prompt}
]
)
res = response.choices[0].message.content
print(res)We can see here again that we explicitly prompt the output structure it should follow. I also tell it the purpose of generating topics (to promote diversity) so the model has full context.
We then parse the data into a list of cluster-mapping jsons and a list of topics
parts = res.split("\n\n")
cluster_mapping_part = parts[0]
new_topics_part = parts[1]
# Parse cluster topic mapping
cluster_topic_mapping_lines = cluster_mapping_part.split("\n")[1:] # Skip the first two lines
cluster_topic_mapping = [{"cluster": int(line.split(",")[0].split(":")[1].strip()), "topic": line.split(":")[2].strip()} for line in cluster_topic_mapping_lines]
# Parse new topics
new_topics_lines = new_topics_part.split("\n")[1:] # Skip the first line
new_topics = [line.split(". ")[1] for line in new_topics_lines]
cluster_topic_mapping, new_topicsAnd finally we can use this information to further prompt a model to keep generating synthetic data. We do this by passing all the topics in the list of jsons to the prompt below.
output_string = ""
for i in range(3):
question = f"""
I am creating input output training pairs to fine tune my gpt model. I want the input to be product name and category and output to be description. the category should be things like: mobile phones, shoes, headphones, laptop, electronic toothbrush, etc. and also more importantly the categories should come under some main topics: {[entry['topic'] for entry in cluster_topic_mapping]})
After the number of each example also state the topic area. The format should be of the form:
1. topic_area
Input: product_name, category
Output: description
Do not add any extra characters around that formatting as it will make the output parsing break.
Here are some helpful examples so you get the style of output correct.
1) clothing
Input: "Shoe Name, Shoes"
Output: "Experience unparalleled comfort. These shoes feature a blend of modern style and the traditional superior cushioning, perfect for those always on the move."
"""
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "system", "content": "You are a helpful assistant designed to generate synthetic data."},
{"role": "user", "content": question}
]
)
res = response.choices[0].message.content
output_string += res + "\n" + "\n"
print(output_string)You can run this in a loop to append to your previous data and in this way you can keep generating more textual synthetic data to train another GPT model while making sure that we cater to imbalanced datasets and generating a diversity of data.
You have now completed part 1 of the synthetic data generation tutorial where we have gone through:
- CSV with a structured prompt
- CSV with a Python program
- Multitable CSV with a python program
- Simply creating textual data
- Dealing with imbalanced or non-diverse textual data
In part 2 you will find find out techniques for better prompting an LLM to enhance textual synthetic data generation.