> ## 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 hızlı başlangıç: CometAPI ile görsel oluşturun

> CometAPI üzerinden bir GPT görseli oluşturun, `b64_json` çıktısını decode edin ve sonucu curl, Python veya Node.js ile kaydedin.

## Ne oluşturacaksınız

`POST /v1/images/generations` çağrısı yapacak, bir GPT image modeliyle tek bir görsel oluşturacak, dönen `b64_json` değerini decode edecek ve bunu bir görsel dosyası olarak kaydedeceksiniz.

## Önkoşullar

* `COMETAPI_KEY` içinde saklanan bir CometAPI API anahtarı
* Dosya kaydetme örnekleri için Python 3.10+ veya Node.js 18+
* Sunucu taraflı bir ortam. Gizli bir anahtarla görsel oluşturmayı herkese açık frontend kodundan çağırmayın.

## API anahtarı, temel URL, kimlik doğrulama

OpenAI uyumlu image endpoint'ini kullanın:

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

Bir Bearer token ile kimlik doğrulaması yapın:

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

## Kod örnekleri

Kopyalanabilir cURL, Python ve Node.js örnekleri için aşağıdaki sekmeleri kullanın.

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

## Akış açıklaması

GPT image generation, tamamlanmış yanıtı tek bir istekte döndürür. GPT image modelleri, `data[0].b64_json` içinde base64 görsel verisi döndürür. Bu değeri decode edin ve baytları `output_format` ile eşleşen bir dosyaya yazın.

URL çıktısına ihtiyacınız varsa, seçilen modelin URL yanıtlarını destekleyip desteklemediğini kontrol edin. GPT image modelleri, korunan referans örneğinde base64 çıktı kullanır.

## Yaygın parametreler

| Parameter       | Use                                                                                     |
| --------------- | --------------------------------------------------------------------------------------- |
| `model`         | GPT image model ID. Referans örnek `gpt-image-2` kullanır.                              |
| `prompt`        | Oluşturulacak görselin metin açıklaması.                                                |
| `size`          | İstenen çıktı boyutu. Desteklenen değerler seçilen modele bağlıdır.                     |
| `quality`       | Bunu destekleyen modeller için kalite ayarı.                                            |
| `output_format` | GPT image sonuçları için encode edilmiş görsel türü; örneğin `jpeg`, `png` veya `webp`. |

## Sorun giderme / SSS

<AccordionGroup>
  <Accordion title="Kaydedilen dosya açılmıyor">
    `b64_json` değerini base64 baytları olarak decode ettiğinizi ve `output_format` ile eşleşen dosya uzantısını kaydettiğinizi doğrulayın.
  </Accordion>

  <Accordion title="Model bir parametreyi reddediyor">
    Görsel parametreleri modele göre değişir. En temel referans örnekle başlayın, ardından isteğe bağlı alanları birer birer ekleyin.
  </Accordion>

  <Accordion title="Yanıtta URL yok">
    GPT image modelleri için `b64_json` kullanın. URL çıktısı modele özeldir.
  </Accordion>
</AccordionGroup>

## Sonraki adımlar

* [Create image API reference](/api/image/openai/images) belgesini okuyun.
* [Models](/tr/overview/models) içinde image model ID'lerini bulun.
* [Estimate request cost before calling a model](/tr/guides/how-to-estimate-cost-before-calling-a-model) ile istek maliyetini tahmin edin.
* [Error codes and retry strategy](/tr/guides/error-codes-and-retry-strategy) ile hataları yönetin.