Uç noktalar

Görsel üretimi

POST /images/generations ile GPT image, Gemini image, FLUX ve Seedream gibi modellerle görsel üretin ve düzenleyin; parametreler, yanıt ve fiyatlandırma.

Playground’da dene

Katalogdaki tüm görsel modelleriyle (GPT image, Gemini image, FLUX, Seedream, Recraft ve daha fazlası) görsel üretin ve düzenleyin. Uç nokta OpenAI SDK'sının yolunu kullanır; bu yüzden client.images.generate(...) değişiklik yapmadan çalışır.

POST https://api14.com/api/v1/images/generations

POST /api/v1/images takma ad olarak kabul edilir. İkisi de gövdeyi değiştirmeden iletir.

İstek

Parametre	Tür	Zorunlu	Açıklama
`model`	string	evet	Bir görsel model kimliği, örn. `openai/gpt-5.4-image-2`.
`prompt`	string	evet	Çizilecek içerik.
`n`	integer	hayır	Görsel sayısı. Her görsel faturalandırılır.
`size`	string	hayır	örn. `1024x1024`, `1536x1024`. Desteklenen boyutlar modele göre değişir.
`aspect_ratio`	string	hayır	örn. `16:9`, `1:1`; boyut yerine oran alan modeller için.
`quality`	string	hayır	Desteklenen yerlerde örn. `low`, `medium`, `high`.
`response_format`	string	hayır	Desteklenen yerlerde `b64_json` veya `url`.
`image`	string veya string[]	hayır	Düzenleme / image-to-image için URL veya `data:` URI olarak referans görsel(ler).

Modele özgü seçenekler (çözünürlükler, en boy oranları) GET /images/models çıktısında ve her model sayfasında listelenir.

Örnek

import OpenAI from "openai";

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

const result = await client.images.generate({
  "model": "openai/gpt-5.4-image-2",
  "prompt": "A minimalist product photo of a ceramic mug on a wooden table",
  "n": 1,
  "aspect_ratio": "1:1"
});
import { writeFile } from "node:fs/promises";
await writeFile("image.png", Buffer.from(result.data[0].b64_json, "base64"));

Yanıt

{
  "created": 1791100000,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }
  ],
  "usage": { "cost": 0.04 }
}

Bazı modeller b64_json yerine url döndürür. Barındırılan URL'leri vakit kaybetmeden indirin; süresi dolabilir.

Chat üzerinden görsel

Metin de çıktılayabilen görsel modeller, modalities ile Chat completions üzerinden çağrılabilir:

{
  "model": "google/gemini-2.5-flash-image",
  "modalities": ["image", "text"],
  "messages": [{ "role": "user", "content": "A watercolor fox, square" }]
}

Üretilen görseller choices[0].message.images[] içinde data URL olarak döner.

Görsel modellerini listeleme

# Public, no API key needed
curl https://api14.com/api/v1/images/models
curl "https://api14.com/api/v1/models?category=image"

Fiyatlandırma

Görsel modeller, modele bağlı olarak görsel başına veya 1M görsel token'ı başına listelenen fiyattan faturalandırılır. Tam maliyet sağlayıcının yanıtından alınır ve USD bakiyenizden düşülür.

Hatalar

Durum	Kod	Ne zaman
400	`model_required` / `invalid_json`	`model` eksik veya gövde hatalı.
402	`insufficient_balance`	USD bakiyeniz 0.
403	`model_not_allowed` / `plan_required`	Anahtar izin listesi veya plan modeli dışlıyor.
404	`model_not_found`	Bilinmeyen veya devre dışı model kimliği.
413	`payload_too_large`	Gövde (örn. satır içi referans görseller) boyut limitini aşıyor.

Sağlayıcı tarafı doğrulama hataları (desteklenmeyen boyut, içerik politikası) durum kodlarıyla aynen iletilir. Bkz. Hatalar.