# Generate Synthetic Data

The Synthetic Data Generation API is a versatile tool designed to create synthetic datasets based on user-defined prompts and specifications regarding the number of rows required. This API allows developers to generate artificial datasets that mimic real-world data while meeting specific criteria provided by the user.

#### Pricing

Requests made to the Synthetic Data Generation API are billed.

The pricing for API requests is as follows:

* **Per Request Cost**: 3 units base cost per request.

<mark style="color:green;">`POST`</mark> `https://api.autogon.ai/api/v1/services/generate-data/`

This API endpoint takes two json parameters the "prompt", and number of rows as the "rows" parameter respectively

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                     | Type   | Description                                                                                                                                 |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| prompt<mark style="color:red;">\*</mark> | String | User-defined prompts specifying the structure and characteristics of the dataset. (Ex. "insurance dataset with the columns (name, amount)") |
| rows<mark style="color:red;">\*</mark>   | String | Number of rows needed in the generated dataset.                                                                                             |

{% tabs %}
{% tab title="200: OK Success status and message containing the dataset url" %}

```json
{
    "status": true, 
    "message": "www.generated_dataset_url"
}
```

{% endtab %}
{% endtabs %}