Görüntü oluşturma

POST /v1/images/generations

OpenAI ile uyumlu açılır images.generate SDK'dır. Sağlayıcıya özgü parametreler standart olanların yanında yer alır; arka uç, her modelin anladığını iletir.

Ortak parametreler

Temel örnek

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A cute baby sea otter floating on its back",
    "n": 1,
    "response_format": "url"
  }'

Tepki şekli

{
  "created": 1715000000,
  "data": [{
    "url": "https://.../image.jpeg"
  }]
}

Akış varyantı

Geçmek sse: true sıkı boşta kalma zaman aşımlarına sahip ara yazılım aracılığıyla proxy yaparken. Yanıt, JSON'un tamamını içeren bir SSE olayıdır, ardından [DONE].

data: {"created":1715000000,"data":[{"url":"https://.../image.jpeg"}]}

data: [DONE]

Görüntüden görüntüye ve referans

Şunlara sahip modeller: image_caps.max_input_images > 0 referans görsellerini kabul edin. URL'leri veya base64 kodlu verileri iletin.

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "Same character, now in a snowy forest",
    "aspect_ratio": "16:9",
    "input_images": [
      {"url": "https://example.com/character.jpg"}
    ]
  }'

Görüntü düzenleme

OpenAI uyumlu düzenleme endpoint’i. Kaynak görüntüyü, OpenAI SDK’larının images.edit için yaptığı gibi multipart dosya olarak gönderin ya da yukarıdaki JSON gövdesini input_images ile gönderin. /v1/images/generations ile aynı yolu izler: aynı modeller, fiyatlar ve yanıt biçimi.

curl https://api.airforce/v1/images/edits \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "model=nano-banana-2" \
  -F "prompt=Same character, now in a snowy forest" \
  -F "[email protected]" \
  -F "aspect_ratio=16:9"

from openai import OpenAI

client = OpenAI(base_url="https://api.airforce/v1", api_key="sk-air-YOUR_API_KEY")

with open("character.png", "rb") as image:
    result = client.images.edit(
        model="nano-banana-2",
        image=image,
        prompt="Same character, now in a snowy forest",
    )
print(result.data[0].url)

İstek başına en fazla 16 girdi görüntüsü, her biri 25 MB; modelin kendi sınırı image_caps.max_input_images alanındadır. Girdi görüntüsü olmayan bir istek, metinden görüntüye çağrısına dönüşmek yerine 400 ile reddedilir. Her girdi görüntüsü, model sayfasında gösterildiği gibi fiyatı artırabilir.

Modele özgü parametreler

Yukarıdaki ortak parametrelerin ötesinde, bireysel model aileleri ekstraları kabul eder. Bilinmeyen parametreler olduğu gibi yukarı akışa iletilir, böylece gelecekte sağlayıcıya özel herhangi bir düğme bir SDK güncellemesi olmadan da çalışır.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 ve suno-v5.5 bu uç noktada geçmişte kabul ediliyordu. Artık şuradaki yerli müzik API’sine aitler: /v1/audio/music — buradaki çağrılar `wrong_endpoint` ile reddedilir.

Yetenekleri keşfetme

Her görüntü modeli ortaya çıkar image_caps Açık /v1/models böylece istemciler girişleri göndermeden önce doğrulayabilirler:

Görsel fiyatlandırması image_caps üzerinde değildir — maliyet için modelin /v1/models üzerindeki fiyat alanlarını kullanın.