توليد الصورة

POST /v1/images/generations

منسدل متوافق مع OpenAI images.generate SDK. تعمل المعلمات الخاصة بالموفر جنبًا إلى جنب مع المعلمات القياسية، حيث تقوم الواجهة الخلفية بإعادة توجيه ما يفهمه كل نموذج.

المعلمات المشتركة

مثال أساسي

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"
  }'

شكل الرد

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

البديل الجري

يمر sse: true عند استخدام الوكيل من خلال البرامج الوسيطة ذات مهلات الخمول الضيقة. الاستجابة هي حدث SSE واحد مع JSON الكامل [DONE].

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

data: [DONE]

صورة إلى صورة ومرجع

نماذج مع image_caps.max_input_images > 0 قبول الصور المرجعية. قم إما بتمرير عناوين URL أو البيانات المشفرة بـ base64.

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"}
    ]
  }'

تعديل الصور

نقطة التعديل المتوافقة مع OpenAI. أرسل الصورة المصدر كملف multipart، كما تفعل حزم OpenAI البرمجية في images.edit، أو أرسل جسم JSON الموضح أعلاه مع input_images. تسلك المسار نفسه الذي يسلكه /v1/images/generations: النماذج والأسعار وشكل الاستجابة نفسها.

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)

حتى 16 صورة إدخال لكل طلب، بحجم 25 ميغابايت لكل منها؛ والحد الخاص بالنموذج هو image_caps.max_input_images. يُرفض الطلب الذي لا يحتوي على صورة إدخال بالرمز 400 بدلًا من أن يصبح استدعاءً لتحويل النص إلى صورة. قد تزيد كل صورة إدخال السعر، كما هو موضح في صفحة النموذج.

المعلمات الخاصة بالنموذج

بالإضافة إلى المعايير المشتركة المذكورة أعلاه، تقبل العائلات النموذجية الفردية الإضافات. تتم إعادة توجيه المعلمات غير المعروفة إلى المنبع كما هي، لذا فإن أي مقبض مستقبلي خاص بالموفر يعمل أيضًا بدون تحديث SDK.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

كانت suno-v4.5 وsuno-v5 وsuno-v5.5 مقبولة تاريخيًا على نقطة النهاية هذه. أصبحت الآن تابعة لواجهة الموسيقى الأصلية على /v1/audio/music — وتُرفض الاستدعاءات هنا بخطأ `wrong_endpoint`.

اكتشاف القدرات

يعرض كل نموذج الصورة image_caps على /v1/models حتى يتمكن العملاء من التحقق من صحة المدخلات قبل الإرسال:

تسعير الصور ليس ضمن image_caps — استخدم حقول السعر الخاصة بالنموذج على /v1/models لمعرفة التكلفة.