KozeAI, OpenAI tarzı görüntü oluşturma ve düzenleme arayüzleri sunar. Görüntü arayüzü, tek tip bir görüntü yanıt formatı döndürür; ancak modelin desteklediği belirli boyut, kalite, referans görüntü ve çıktı formatı kanal adaptörü tarafından belirlenir.

Görüntü Oluşturma API Dokümantasyonu

KozeAI, OpenAI tarzı görüntü oluşturma ve düzenleme arayüzleri sağlar. Görüntü arayüzü, tek tip bir görüntü yanıt formatı döndürür, ancak desteklenen belirli model boyutu, kalitesi, referans görüntüsü ve çıktı formatı kanal adaptörü tarafından belirlenir.

Kimlik Doğrulama

Tüm istekler Authorization: Bearer aracılığıyla doğrulanır. Konsolda bir API belirteci oluşturulduktan sonra kullanılır.

export KOZEAI_API_KEY='sk-your-token'

export KOZEAI_BASE_URL='https://your-kozeai-domain'

API Genel Bakış

Görüntü modeli ayrıca

/v1/chat/completions

üzerinden de çağrılabilir. Sohbet arayüzü, metin ve mesajlardan görüntüleri çıkaracak ve ardından bunları görüntü arayüzü formatına dönüştürecektir; Doğrudan bağlantı kurarken yukarıdaki özel görüntü arayüzünü kullanmanız önerilir.

1.

curl '$KOZEAI_BASE_URL/v1/images/generations' \

-H 'Authorization: Bearer $KOZEAI_API_KEY' \

-H 'Content-Type: application/json' \

-d '{

'model': 'gpt-image-1',

'prompt': 'Pencere kenarında oturan turuncu bir kedi, sinematik ışık ve gölge',

'n': 1,

'size': '1024x1024',

'quality': 'auto',

'response_format': 'url'

}

İstek

Parametreler

Yöntem	Yol	İçerik Türü	Amaç
POST	`/v1/images/generations`	`application/json`	Metinden Oluşturulan Görüntüler

dall-e-3

Parametreler	Tür	Gerekli	Açıklama
`model`	string	Eşit mi	Görüntü modeli adı. Mevcut modeller, `/v1/models` adresinden gelen verilere dayanmaktadır.
`istem`	string	Evet	Görüntü içeriği açıklaması. Boş olmayan bir dize kullanılması önerilir.
`n`	tamsayı	Hayır	Oluşturulan öğe sayısı, varsayılan `1`, genel doğrulama aralığı `1-10`'dur.
`boyut`	dize	Hayır	Görüntü boyutu veya en boy oranı, belirli değer model tarafından belirlenir.
`kalite`	dize	Hayır	Kalite seviyesi, yaygın değerler `standart`, `hd`, `otomatik`, `2k`, `4k`'dır.
`yanıt_biçimi`	dize	Hayır	Yaygın değerler `url` veya `b64_json`'dır.
`stil`	herhangi	Hayır	OpenAI uyumlu stil parametresi.
`kullanıcı` / `user_id`	herhangi	Hayır	Arayan kullanıcının tanımlayıcısı.
`ekstra_alanlar`	nesne	Hayır	Ek yapılandırılmış parametre; Etkinliği kanal adaptörüne bağlıdır.
`arka plan`	herhangi	Hayır	Arka plan ayarları.
`denetim`	herhangi	Hayır	İçerik denetimi ayarları.
`çıktı formatı`	herhangi	Hayır	Çıktı görüntü formatı.
`çıktı_sıkıştırma`	tamsayı	Hayır	Bazı Codex görüntü modelleri tarafından desteklenen çıktı sıkıştırma parametresi.
`kısmi_görüntüler`	tamsayı	Hayır	Bazı Codex görüntü modelleri tarafından desteklenen bazı görüntü/akışla ilgili parametreler.
`suyu`	mantıksal	Hayır	Suyu işareti anahtarı, etkinliği kanala bağlıdır.
`watermark_enabled`	any	No	Compatible with some upstream watermark parameters.
`image`	string/object/array	No	Resim URL'sine, veri URL'sine veya resim nesnesine bakın; Bazı kanallar otomatik olarak düzenleme sürecine girecektir.
Varsayılanlar
`dall-e-2` / `dall-e`	`256x256`、`512x512`、`1024x1024`	`1024x1024`
`1024x1024`, `1024x1792`, `1792x1024`	`1024x1024`
`gpt-image-1` / `gpt-image-2`	Yukarı akış modeli tarafından belirlenir	`quality=auto`

size Yarım genişlikte harfler x kullanılmalıdır, çarpma işaretleri × kullanılmamalıdır.

2. Görüntü Düzenleme

Standart düzenleme istekleri, image adlı görüntü alanına sahip çok parçalı formu kullanır.

Birden fazla giriş görüntüsü, image veya image[] kullanılarak yeniden kullanılabilir.

curl '$KOZEAI_BASE_URL/v1/images/edits' \
-H 'Authorization: Bearer $KOZEAI_API_KEY' \
-F 'model=gpt-image-1' \
-F 'prompt=Arka planı gece sahnesine değiştirin ve konu ayrıntılarını koruyun' \
-F 'image=@./input.png' \
-F 'n=1' \
-F 'quality=standard'

Ortak Form

Alanlar:

Alan	Tür	Açıklama
`model`	string	Görüntü düzenleme modeli.
`prompt`	string	Düzenleme gereksinimleri.
`image` / `image[]`	file	En az bir görüntü girin.
`maske`	dosya	Maske görüntüsü; Öncelikle OpenAI/Codex uyumlu düzenleme iş akışları için kullanılır.
`n`	tamsayı	Oluşturulan öğe sayısı, varsayılan `1`, aralık `1-10`.
`boyut`	dize	Çıktı boyutu veya oranı.
`kalite`	dize	Çıktı kalitesi.
`yanıt_biçimi`	dize	`url` veya `b64_json`, kanala bağlı olarak.
`su işareti`	mantıksal	Su işareti anahtarı, kanala bağlı olarak.

Bazı kanallar ayrıca JSON düzenleme isteklerini de destekler, örneğin resim'i bir veri URL'sine veya resim URL'sine ayarlamak gibi; ancak OpenAI, Codex ve ChatGPT OAuth düzenleme yolları tercihen çok parçalı format kullanır.

3. Kanal Farklılıkları

Kanal	Ek Davranışlar
OpenAI / DALL·E	OpenAI görüntü alanı tarafından iletilir; DALL·E, `boyut` için katı doğrulama uygular.
xAI	`boyut`, `en boy oranı` ve `çözünürlük`'e dönüştürülecektir; `yanıt biçimi` varsayılan olarak `b64_json`'dur. `en boy oranı` ve `çözünürlük` gibi ek JSON parametreleri desteklenir.
Akış	`boyut` 1:1, 16:9, 9:16, 4:3 ve 3:4 en boy oranlarını destekler; `kalite=2k/4k` ölçeklendirme işlemini tetikler. Referans görüntüler `görüntü` aracılığıyla yüklenir.
Jimeng / Dreamina	`boyut` en boy oranı eşlemesi için kullanılır; `kalite=hd` daha yüksek çözünürlük seçecektir; referans görüntü harmanlama işlemine girecektir.
Codex	Ayrıca `input_fidelity`, `mask`, `stream`, `output_format`, `output_compression`, `partial_images` özelliklerini de destekler.
ChatGPT OAuth	Aslında `model`, `prompt`, `n` parametrelerini kullanır ve görüntüleri düzenler; diğer görüntü parametreleri göz ardı edilebilir.
Grok	`response_format` Yalnızca `url` veya `b64_json` formatlarını destekler, varsayılan `url`'dir; düzenleme istekleri en az bir resim gerektirir.

Genel alanlarda tanımlanmayan parametrelerin otomatik olarak iletilmesi garanti edilmez. Yalnızca ilgili kanal adaptörü tarafından açıkça okunan ek parametreler geçerli olacaktır.

4. Yanıt Biçimi

{

"created": 1751000000,

"data": [
{
"url": "https://example.com/generated.png",

"b64_json": "",

"revised_prompt": "Pencere kenarında oturan turuncu bir kedi, sinematik ışık ve gölge"

}
]

}

`response_format=b64_json` kullanıldığında, resim içeriği `data[].b64_json` içinde bulunur; URL biçimi kullanıldığında, resim adresi `data[].url` içinde bulunur. Farklı kanallar, kullanılmayan alanlar için boş dizeler döndürebilir.

5. JavaScript çağrı örneği

const baseURL = process.env.KOZEAI_BASE_URL;

const apiKey = process.env.KOZEAI_API_KEY;

const response = await fetch(`${baseURL}/v1/images/generations`, {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,

'Content-Type': 'application/json',

},

body: JSON.stringify({
model: 'gpt-image-1',

prompt: 'Beyaz arka plan üzerinde minimal bir ürün illüstrasyonu',

n: 1, size: 1024x1024,

response_format: url,

}),

});

if (!response.ok) {

throw new Error(await response.text());

}
const result = await response.json();

console.log(result.data[0].url || result.data[0].b64_json);

6. Sıkça Sorulan Hatalar

model is required: Model adı geçirilmedi.
prompt is required: Prompt kelimesi boş.
n must be between 1 and 10: Üretim miktarı genel sınırı aşıyor.
size must be one of ...: DALL·E desteklenmeyen bir boyut kullanıyor.
image is required: Düzenleme arayüzü bir resim yüklemedi veya tanınabilir bir resim referansı sağlamadı.
desteklenmeyen ... yanıt_biçimi: Hedef kanal, istenen çıktı biçimini desteklemiyor.

Görüntü oluşturma API'sinin çağrı dokümantasyonu