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

# Текст в изображение

### Как создавать изображения с помощью API sunra

Чтобы создавать изображения с помощью API sunra, отправьте запрос на указанную конечную точку, включив в него входные параметры. API использует предварительно обученные модели для создания изображений на основе текстовых подсказок, что позволяет создавать визуальные эффекты, описывая их на естественном языке.

Вот пример создания изображения из текста с помощью 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: 'Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.',
      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": "Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.",
          "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", "Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.",
      "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("\nОбновление статуса: %s, ID запроса: %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("Завершено!");
  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":"Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.","prompt_enhancer":true,"aspect_ratio":"16:9","output_format":"jpeg","safety_tolerance":2}'
  ```
</CodeGroup>

### Как выбрать модель

sunra предоставляет различные модели для создания изображений. Выберите ту, которая соответствует вашим потребностям, в зависимости от желаемого стиля и качества.

Доступные модели включают:

* **[black-forest-labs/flux-kontext-pro](https://sunra.ai/models/black-forest-labs/flux-kontext-pro)**: единая модель, обеспечивающая локальное редактирование, генеративные модификации и генерацию текста в изображение в качестве FLUX.1. Обрабатывает текстовые и графические входные данные для точных региональных правок или полных преобразований сцены с революционной скоростью, являясь пионером итерационных рабочих процессов, которые поддерживают согласованность персонажей в течение нескольких этапов редактирования.
* **[black-forest-labs/flux-1.1-pro](https://sunra.ai/models/black-forest-labs/flux-1.1-pro)**: лучшее из FLUX, предлагающее современную производительность генерации изображений на молниеносной скорости с первоклассным следованием подсказкам, визуальным качеством, детализацией изображения и разнообразием вывода.
* **[google-deepmind/imagen4](https://sunra.ai/models/google-deepmind/imagen4)**: Imagen 4 создает фотореалистичные изображения 2K с мелкими деталями, точным текстом и поддержкой многоязычных подсказок.

Чтобы выбрать модель, укажите ее идентификатор в методе подписки, как показано. Изучите больше моделей на странице [Модели преобразования текста в изображение](https://sunra.ai/models?modalities%5B0%5D=modality-text-image).