README.md

---
title: Synthetic Text Generator
emoji: 📝
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.29.0
app_file: app.py
pinned: false
license: apache-2.0
---

# Synthetic Text Generator using OpenRouter

This Space uses models available via [OpenRouter.ai](https://openrouter.ai/) to generate synthetic text based on user prompts.

## How to Use

1.  **Enter a Prompt:** Describe the kind of text you want to generate in the "Prompt" field.
2.  **Choose a Model:** Specify the OpenRouter Model ID (you can find available models on the OpenRouter website). Examples: `deepseek/deepseek-chat-v3-0324:free`, `openai/gpt-3.5-turbo`, `google/gemini-flash-1.5`.
3.  **Set Number of Samples:** Choose how many variations you want.
4.  **Click Generate:** View the results in the "Generated Samples" box.

## Setup

**IMPORTANT:** To use this Space, you need to add your OpenRouter API key as a secret:

1.  Go to your OpenRouter dashboard to get your API key.
2.  In this Hugging Face Space, go to the **Settings** tab.
3.  Scroll down to the **Repository secrets** section.
4.  Click **New secret**.
5.  Enter `OPENROUTER_API_KEY` as the **Name**.
6.  Paste your OpenRouter API key into the **Value** field.
7.  Click **Add secret**.

The Space should now be able to authenticate with the OpenRouter API.