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. Antes de comenzar, asegúrate de tener una clave de API de tu panel de control, 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: 
npm install @sunra/client
Establece tu clave de API como una variable de entorno: 
export SUNRA_KEY="your-api-key-here"
Una vez configurado, puedes invocar nuestro endpoint de la API del Modelo usando el cliente de sunra: 
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: 
pip install sunra-client
Establece tu clave de API como una variable de entorno: 
export SUNRA_KEY="your-api-key-here"
Configura y usa el cliente: 
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: 
implementation("ai.sunra.client:sunra-client:0.1.5")
Establece tu clave de API como una variable de entorno: 
export SUNRA_KEY="your-api-key-here"
Configura y usa el cliente: 
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. 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.