> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqwish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the Sqwish API documentation

## Welcome to Sqwish API

Welcome to the Sqwish API documentation. This guide will help you understand how to use our real-time prompt optimization API.

With Sqwish, you can optimize long text prompts into shorter, token-efficient versions, saving computation and costs when working with large language models.

<Card title="Get Started" icon="rocket" href="/setup" horizontal>
  Set up your API key and start optimizing prompts in minutes.
</Card>

## Key Features

<Columns cols={2}>
  <Card title="Real-time Optimization" icon="bolt">
    Optimize prompts instantly with our advanced AI models.
  </Card>

  <Card title="Token Reduction" icon="chart-line-down">
    Save costs by reducing token usage while maintaining quality.
  </Card>

  <Card title="Multiple Languages" icon="code">
    Support for Python, JavaScript, and direct API calls.
  </Card>

  <Card title="Easy Integration" icon="plug">
    Simple REST API that works with any application.
  </Card>
</Columns>

## Quick Example

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    from sqwishai import Sqwish
    import os

    sqwish_client = Sqwish(os.environ.get("SQWISH_API_KEY"))

    input_prompt = "Write a haiku about recursion in programming."
    response = sqwish_client.text.optimize(input_prompt)
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    const { Sqwish } = require('sqwishai');
    const sqwishClient = new Sqwish(process.env.SQWISH_API_KEY);

    const inputPrompt = "Write a haiku about recursion in programming.";
    const response = sqwishClient.text.optimize(inputPrompt);
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.sqwish.ai/v1/optimization/optimize" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $SQWISH_API_KEY" \
      -d '{
        "text": "Write a haiku about recursion in programming.",
        "target_model": "gpt4o",
        "optimization_model": "latest"
    }'
    ```
  </Tab>
</Tabs>

## Use Cases

* **Reduce latency** in real-time or low-latency environments
* **Handle longer documents** within a single context window
* **Keep chatbots snappy** even as conversations grow
* **Lower costs** for frequent short prompts
* **Fit more documents** into RAG flows
