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

# Texto para Imagem

### Como gerar imagens usando a API da sunra

Para criar imagens com a API da sunra, envie uma solicitação ao endpoint especificado, incluindo seus parâmetros de entrada. A API utiliza modelos pré-treinados para gerar imagens com base em prompts de texto, permitindo que você produza visuais descrevendo-os em linguagem natural.

Aqui está um exemplo de como gerar uma imagem a partir de texto usando a API da 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: 'Um bule de vidro com chá de flores desabrochando dentro, colocado em uma mesa de madeira perto de uma janela ensolarada com uma suave luz da manhã.',
      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": "Um bule de vidro com chá de flores desabrochando dentro, colocado em uma mesa de madeira perto de uma janela ensolarada com uma suave luz da manhã.",
          "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", "Um bule de vidro com chá de flores desabrochando dentro, colocado em uma mesa de madeira perto de uma janela ensolarada com uma suave luz da manhã.",
      "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("\nAtualização de status: %s, ID da solicitação: %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("Concluído!");
  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":"Um bule de vidro com chá de flores desabrochando dentro, colocado em uma mesa de madeira perto de uma janela ensolarada com uma suave luz da manhã.","prompt_enhancer":true,"aspect_ratio":"16:9","output_format":"jpeg","safety_tolerance":2}'
  ```
</CodeGroup>

### Como Selecionar o Modelo

A sunra oferece vários modelos de geração de imagens. Escolha um que atenda às suas necessidades com base no estilo e na qualidade desejados.

Os modelos disponíveis incluem:

* **[black-forest-labs/flux-kontext-pro](https://sunra.ai/models/black-forest-labs/flux-kontext-pro)**: Um modelo unificado que oferece edição local, modificações generativas e geração de texto para imagem com qualidade FLUX.1. Processa entradas de texto e imagem para edições regionais precisas ou transformações de cena completas em velocidades inovadoras, sendo pioneiro em fluxos de trabalho iterativos que mantêm a consistência do personagem em várias rodadas de edição.
* **[black-forest-labs/flux-1.1-pro](https://sunra.ai/models/black-forest-labs/flux-1.1-pro)**: O melhor do FLUX, oferecendo geração de imagens de desempenho de última geração em velocidades incríveis com acompanhamento de prompt de primeira linha, qualidade visual, detalhes de imagem e diversidade de resultados.
* **[google-deepmind/imagen4](https://sunra.ai/models/google-deepmind/imagen4)**: O Imagen 4 gera imagens fotorrealistas de 2K com detalhes finos, texto preciso e suporte a prompts multilíngues.

Para selecionar um modelo, especifique seu ID no método de inscrição, conforme mostrado. Explore mais modelos na página [Modelos de Texto para Imagem](https://sunra.ai/models?modalities%5B0%5D=modality-text-image).