> ## 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.

# Da testo a immagine

### Come generare immagini utilizzando l'API sunra

Per creare immagini con l'API sunra, invia una richiesta all'endpoint specificato includendo i parametri di input. L'API sfrutta modelli pre-addestrati per generare immagini basate su prompt di testo, consentendoti di produrre immagini descrivendole in linguaggio naturale.

Ecco un esempio di generazione di un'immagine da testo utilizzando l'API sunra:

<CodeGroup>
  ```javascript Javascript theme={null}
  import { sunra } from "@sunra/client";

  const result = await sunra.subscribe("black-forest-labs/flux-kontext-max/text-to-image", {
    input: {
      prompt: 'Una teiera di vetro con tè ai fiori che sbocciano all\'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.',
      prompt_enhancer: true,
      aspect_ratio: '16:9',
      output_format: 'jpeg',
      safety_tolerance: 2
    },
    logs: true,
    onQueueUpdate: (update) => {
      console.log(update)
    },
  });
  console.log(result.data);
  console.log(result.requestId);
  ```

  ```python Python theme={null}
  import sunra_client

  result = sunra_client.subscribe(
      "black-forest-labs/flux-kontext-max/text-to-image",
      arguments={
          "prompt": "Una teiera di vetro con tè ai fiori che sbocciano all'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.",
          "prompt_enhancer": True,
          "aspect_ratio": "16:9",
          "output_format": "jpeg",
          "safety_tolerance": 2
      },
      with_logs=True,
      on_enqueue=print,
      on_queue_update=print,
  )
  print(result)
  ```

  ```java 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", "Una teiera di vetro con tè ai fiori che sbocciano all'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.",
      "prompt_enhancer", true,
      "aspect_ratio", "16:9",
      "output_format", "jpeg",
      "safety_tolerance", 2
  );

  Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
      String status = update.getStatus().toString();
      String message = String.format("\nAggiornamento stato: %s, ID richiesta: %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-max/text-to-image", options);
  System.out.println("Completato!");
  System.out.println(response.getData());
  ```

  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.sunra.ai/v1/queue/black-forest-labs/flux-kontext-max/text-to-image \
    --header "Authorization: Key $SUNRA_KEY" \
    --header "Content-Type: application/json" \
    --data '{"prompt":"Una teiera di vetro con tè ai fiori che sbocciano all\'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.","prompt_enhancer":true,"aspect_ratio":"16:9","output_format":"jpeg","safety_tolerance":2}'
  ```
</CodeGroup>

### Come selezionare il modello

sunra fornisce vari modelli di generazione di immagini. Scegline uno che si adatti alle tue esigenze in base allo stile e alla qualità desiderati.

I modelli disponibili includono:

* **[black-forest-labs/flux-kontext-pro](https://sunra.ai/models/black-forest-labs/flux-kontext-pro)**: Un modello unificato che offre editing locale, modifiche generative e generazione da testo a immagine in qualità FLUX.1. Elabora input di testo e immagini per modifiche regionali precise o trasformazioni complete della scena a velocità rivoluzionarie, aprendo la strada a flussi di lavoro iterativi che mantengono la coerenza del personaggio attraverso più turni di modifica.
* **[black-forest-labs/flux-1.1-pro](https://sunra.ai/models/black-forest-labs/flux-1.1-pro)**: Il meglio di FLUX, che offre una generazione di immagini all'avanguardia a velocità incredibili con un seguito di prompt, qualità visiva, dettagli dell'immagine e diversità di output di altissimo livello.
* **[google-deepmind/imagen4](https://sunra.ai/models/google-deepmind/imagen4)**: Imagen 4 genera immagini fotorealistiche 2K con dettagli precisi, testo accurato e supporto per prompt multilingue.

Per selezionare un modello, specificarne l'ID nel metodo di sottoscrizione come mostrato. Esplora altri modelli nella pagina [Modelli da testo a immagine](https://sunra.ai/models?modalities%5B0%5D=modality-text-image).