İçeriğe geç

Mage API · Görsel modeli

GPT Image 2 API

Hassas prompt'lar ve okunaklı metin

POST https://api.mage.space/v1/gpt_image_2/generate

Bir bakışta

GPT Image 2 API'si, GPT Image 2 ve 4 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/gpt_image_2/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 9 Gems (yaklaşık $0.009) tutar, abonelik gerekmez. GPT Image 2, kayıtlı karakterleri ve prompt içinde @handle ile verilen referansları kabul eder.

  • GörselÇıktı
  • 5Varyantlar
  • 9Görsel başına Gems, varsayılan
  • $0.009Yaklaşık, USD

Genel bakış

GPT Image 2 API ne yapar?

OpenAI'ın GPT Image modelleri, prompt'u harfiyen takip eder ve okunaklı yazılar oluşturur. Birçok referans görselden üret veya düzenle, ya da GPT Image 2.6 ile animasyonlu GIF'ler yap. OpenAI'ın güvenlik filtresi geçerlidir.

Görsel oluşturma ve düzenleme için OpenAI'ın GPT Image modelleri: GPT Image 2, GPT Image 2.5 Flare ve Sunburst ile GPT Image 2.6 Flare ve Sunburst. Bunlar ayrıca animasyonlu GIF de yapabilir. OpenAI'ın güvenlik filtresi geçerlidir.

Girdi olarak image, additional_images kabul eder.

Hızlı başlangıç

GPT Image 2 API'sini çağırma

MAGE_API_KEY'i ayarla, isteği /gpt_image_2/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Modeller

GPT Image 2 model_id değerleri

Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.

model_idAdVarsayılan
gpt-image-2GPT Image 2Evet
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Seçenekler

GPT Image 2 parametreleri

Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.

AlanDeğerler
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Girdiler

GPT Image 2'nin kabul ettiği medya girdileri

Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.

AlanRol
imageReferans görsel.
additional_imagesEk referans görseller.

Kurallar

GPT Image 2 API'sinin uyguladığı kurallar

  • Her model yalnızca bazı `quality` seviyelerini sunar; seçilen modelin sunmadığı bir seviye reddedilir.
  • Animasyonlu GIF için bir GPT Image 2.6 modelinde `output_format` değerini `gif` yap; `frame_count` 2 ile 16 arasında (varsayılan 9), `frame_duration_ms` ise 20 ile 2000 arasında (varsayılan 200) olabilir. Diğer modeller bunu reddeder. `resolution` geçerli değildir: her `aspect_ratio` için 640 piksele yakın tek bir kare boyutu vardır. Sonuç bir `.gif` dosyasıdır ve `type` değeri `image` olarak kalır.
  • GIF fiyatı kare başına değil, `quality` değerine ve içinde bulunduğu kare aralığına (2–8, 9, 10–12 veya 13–16) göre belirlenir. Aşağıdaki fiyat tablosu sabit görselleri gösterir: bir GIF'in fiyatını maliyet tahmininden öğrenebilirsin.
  • Mage'deki bir GIF, örneğin önceki bir sonuç, görsel girdisi olarak verildiğinde ilk karesi üzerinden çalışır. Başka bir yerden gelen GIF reddedilir: Görsel girdileri JPEG veya PNG olmalıdır.

Daha fazla görsel modeli

Mage'deki diğer görsel üretim API'leri

  • Görsel · 90 Gem'den başlayan fiyatlarla

    Grok Image API

    Grok Imagine, iki seviyede

  • Görsel · 37 Gem'den başlayan fiyatlarla

    Guava API

    Fotoğraf sanılacak kadar gerçekçi görseller

  • Görsel · 20 Gem'den başlayan fiyatlarla

    HiDream API

    Hızlı ve çok yönlü, negatif prompt desteğiyle

  • Görsel · 20 Gem'den başlayan fiyatlarla

    Krea 2 API

    Saniyeler içinde muhteşem estetik

  • Görsel · 42 Gem'den başlayan fiyatlarla

    Mango API

    Amiral gemisi görsel model ailemiz

  • Görsel · 15 Gems'ten başlayan fiyatlarla

    MiniMax H3 Image API

    Yerel 16 megapiksel görseller, açık ağırlıklar

SSS

Sık sorulan sorular

GPT Image 2 API'si ne kadar tutuyor?
Varsayılan ayarlarla (GPT Image 2) yapılan bir GPT Image 2 isteği 9 Gems tutar, yani yaklaşık 0,009 $. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta bildirilir. Başarısız olan bir üretimin ücreti iade edilir; Mage'in içerik politikasının engellediği üretiminki iade edilmez.
GPT Image 2 API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/gpt_image_2/generate. Yanıt, sonucu sorgulamak için bir status_url içerir.
Hangi GPT Image 2 modellerini çağırabilirim?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). Varsayılan model GPT Image 2'dir.
GPT Image 2 referans görsellerini veya karakterleri destekliyor mu?
GPT Image 2 image ve additional_images kabul eder. GPT Image 2, kayıtlı karakterleri ve referansları istemde @handle ile alır.
GPT Image 2'yi Claude veya ChatGPT'den kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve GPT Image 2'yi adıyla iste. Asistanın seçeneklerini get_model ile okur ve üretmeden önce fiyatı söyler.
GPT Image 2 sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

CharactersTopluluk