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

# Inicio Rápido

En esta guía, te guiaremos a través del uso de uno de nuestros endpoints de modelo más populares, como [black-forest-labs/flux-kontext-pro/text-to-image](https://sunra.ai/models/black-forest-labs/flux-kontext-pro/text-to-image).
Antes de comenzar, asegúrate de tener una clave de API de tu [panel de control](https://sunra.ai/dashboard/api-tokens),
que es necesaria para autenticar tus solicitudes a la API de sunra.

Elige tu lenguaje de programación preferido a continuación para comenzar:

## JavaScript/Node.js

Para comenzar, instala el paquete del cliente y configúralo con tu clave de API:

<CodeGroup>
  ```bash npm theme={null}
  npm install @sunra/client
  ```

  ```bash pnpm theme={null}
  pnpm add @sunra/client
  ```

  ```bash yarn theme={null}
  yarn add @sunra/client
  ```
</CodeGroup>

Establece tu clave de API como una variable de entorno:

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

Una vez configurado, puedes invocar nuestro endpoint de la API del Modelo usando el [cliente](/client-libraries/javascript) de sunra:

```javascript theme={null}
import { sunra } from "@sunra/client";

// Opcionalmente, configura el cliente con una clave de API diferente a la establecida en la variable de entorno
sunra.config({
  credentials: "YOUR_SUNRA_KEY",
});

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Un conejo con gafas leyendo un libro debajo de un hongo en estilo acuarela.",
    width: 1024,
    height: 768,
    output_format: "jpeg"
  },
});
```

## Python

Instala la biblioteca cliente de Python usando pip:

```bash theme={null}
pip install sunra-client
```

Establece tu clave de API como una variable de entorno:

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

Configura y usa el cliente:

```python theme={null}
import sunra_client

result = sunra_client.subscribe(
    "black-forest-labs/flux-kontext-pro/text-to-image",
    arguments={
        "prompt": "Un conejo con gafas leyendo un libro debajo de un hongo en estilo acuarela.",
        "width": 1024,
        "height": 768,
        "output_format": "jpeg"
    },
    with_logs=True,
    on_enqueue=print,
    on_queue_update=print,
)
print(result)
```

## Java

Agrega la biblioteca cliente de Java a tu proyecto usando tu sistema de compilación preferido:

<CodeGroup>
  ```kotlin Gradle theme={null}
  implementation("ai.sunra.client:sunra-client:0.1.5")
  ```

  ```xml Maven theme={null}
  <dependency>
      <groupId>ai.sunra.client</groupId>
      <artifactId>sunra-client</artifactId>
      <version>0.1.5</version>
  </dependency>
  ```
</CodeGroup>

Establece tu clave de API como una variable de entorno:

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

Configura y usa el cliente:

```java theme={null}
import ai.sunra.client.*;
import ai.sunra.client.queue.*;
import java.util.Map;
import com.google.gson.JsonObject;
import java.util.function.Consumer;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
Map<String, Object> input = Map.of(
    "prompt", "Un conejo con gafas leyendo un libro debajo de un hongo en estilo acuarela.",
    "width", 1024,
    "height", 768,
    "output_format", "jpeg"
);

Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
    String status = update.getStatus().toString();
    String message = String.format("\nActualización de estado: %s, ID de solicitud: %s",
        status, update.getRequestId());
    System.out.println(message);
};

SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
    .input(input)
    .resultType(JsonObject.class)
    .onQueueUpdate(statusUpdateHandler)
    .logs(true)
    .build();

Output<JsonObject> response = client.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", options);
System.out.println("¡Completado!");
System.out.println(response.getData());
```

## Próximos Pasos

Ofrecemos varios modelos como Flux kontext pro y Kling v2 master como API listas para usar. Explóralos en nuestra [Área de Juegos de Modelos](https://sunra.ai/models).

Para usar un modelo, visita su pestaña "API" para encontrar la URL, el código fuente y los ejemplos de uso, lo que te ayudará a integrarlo sin problemas en tus aplicaciones.

Para obtener información más detallada sobre cada biblioteca cliente, visita nuestra [documentación de bibliotecas de cliente](/client-libraries).