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

# Швидкий старт GPT Image API: генеруйте зображення з CometAPI

> Згенеруйте GPT-зображення через CometAPI, декодуйте `b64_json` і збережіть результат за допомогою curl, Python або Node.js.

## Що ви створите

Ви викличете `POST /v1/images/generations`, згенеруєте одне зображення за допомогою GPT image model, декодуєте повернений `b64_json` і збережете його як файл зображення.

## Передумови

* API-ключ CometAPI, збережений у `COMETAPI_KEY`
* Python 3.10+ або Node.js 18+ для прикладів зі збереженням файлів
* Серверне середовище. Не викликайте генерацію зображень із публічного frontend-коду з секретним ключем.

## API-ключ, base URL, автентифікація

Використовуйте OpenAI-сумісний endpoint для зображень:

```text theme={null}
https://api.cometapi.com/v1/images/generations
```

Автентифікуйтеся за допомогою Bearer token:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## Приклади коду

Використовуйте вкладки нижче для готових до копіювання прикладів на cURL, Python і Node.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/images/generations \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-image-2",
      "prompt": "A paper boat floating on calm water at sunrise.",
      "quality": "low",
      "size": "1024x1024",
      "output_format": "jpeg"
    }'
  ```

  ```python Python theme={null}
  import base64
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  image = client.images.generate(
      model="gpt-image-2",
      prompt="A paper boat floating on calm water at sunrise.",
      quality="low",
      size="1024x1024",
      output_format="jpeg",
  )

  image_base64 = image.data[0].b64_json
  with open("cometapi-gpt-image.jpeg", "wb") as file:
      file.write(base64.b64decode(image_base64))
  ```

  ```javascript Node.js theme={null}
  import fs from "node:fs/promises";
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const image = await client.images.generate({
    model: "gpt-image-2",
    prompt: "A paper boat floating on calm water at sunrise.",
    quality: "low",
    size: "1024x1024",
    output_format: "jpeg",
  });

  const imageBase64 = image.data[0].b64_json;
  await fs.writeFile("cometapi-gpt-image.jpeg", Buffer.from(imageBase64, "base64"));
  ```
</CodeGroup>

## Пояснення процесу

Генерація GPT-зображень повертає завершену відповідь в одному запиті. GPT image models повертають зображення у форматі base64 в `data[0].b64_json`. Декодуйте це значення та запишіть байти у файл, що відповідає `output_format`.

Якщо вам потрібен вивід у вигляді URL, перевірте, чи підтримує вибрана модель відповіді у вигляді URL. GPT image models використовують вивід у base64 у наведеному довідковому прикладі.

## Поширені параметри

| Parameter       | Використання                                                                               |
| --------------- | ------------------------------------------------------------------------------------------ |
| `model`         | model ID GPT image model. У довідковому прикладі використовується `gpt-image-2`.           |
| `prompt`        | Текстовий опис зображення, яке потрібно згенерувати.                                       |
| `size`          | Бажаний розмір результату. Підтримувані значення залежать від вибраної моделі.             |
| `quality`       | Налаштування якості для моделей, які це підтримують.                                       |
| `output_format` | Тип закодованого зображення для результатів GPT image, наприклад `jpeg`, `png` або `webp`. |

## Усунення проблем / FAQ

<AccordionGroup>
  <Accordion title="Збережений файл не відкривається">
    Переконайтеся, що ви декодували `b64_json` як байти base64 і зберегли файл із розширенням, що відповідає `output_format`.
  </Accordion>

  <Accordion title="Модель відхиляє параметр">
    Параметри зображення залежать від моделі. Почніть із мінімального довідкового прикладу, а потім додавайте по одному необов’язковому полю за раз.
  </Accordion>

  <Accordion title="У відповіді немає URL">
    Використовуйте `b64_json` для GPT image models. Вивід у вигляді URL залежить від моделі.
  </Accordion>
</AccordionGroup>

## Наступні кроки

* Прочитайте [довідник API Create image](/api/image/openai/images).
* Знайдіть model ID моделей зображень у [Models](/uk/overview/models).
* Оцініть вартість запиту за допомогою [Оцінка вартості запиту перед викликом моделі](/uk/guides/how-to-estimate-cost-before-calling-a-model).
* Обробляйте збої за допомогою [Коди помилок і стратегія повторних спроб](/uk/guides/error-codes-and-retry-strategy).