الانتقال إلى المحتوى الرئيسي
يكشف OrcaRouter عن توليد الصور من خلال مسارين، حسب النموذج الذي تختاره:
  1. /v1/images/generations — يتبع شكل واجهة OpenAI للصور. الأنسب للنماذج المخصّصة لتوليد الصور (عائلة بديلة عن DALL-E، Imagen، Grok Imagine).
  2. /v1/chat/completions — توليد الصور على نمط المحادثة. الأنسب عندما تريد نموذجًا يعيد نصًا وصورة في الدور نفسه (عائلة nano-banana / “imagine” من Gemini).

المسار 1: واجهة الصور المخصّصة

/v1/images/generations يتبع شكل واجهة OpenAI للصور. عائلات النماذج التي تخدم هذه النقطة:
  • OpenAI: openai/gpt-image-1، openai/gpt-image-1-mini، openai/gpt-image-1.5
  • Google Imagen: google/imagen-4.0-fast-generate-001، google/imagen-4.0-generate-001، google/imagen-4.0-ultra-generate-001
  • xAI: grok/grok-imagine-image، grok/grok-imagine-image-pro
curl https://api.orcarouter.ai/v1/images/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "A cat astronaut on Mars, photorealistic",
    "size": "1024x1024"
  }'

المسار 2: توليد الصور عبر chat completions

تستطيع بعض نماذج Gemini إعادة صورة كجزء من دور chat completion عادي. عندما تختار أحد هذه النماذج، يخبر OrcaRouter المزوّد تلقائيًا بأن يُصدر نصًا وصورةً معًا في الاستجابة:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

مثال

from openai import OpenAI

client = OpenAI(base_url="https://api.orcarouter.ai/v1", api_key="sk-orca-...")

resp = client.chat.completions.create(
    model="google/gemini-2.5-flash-image",
    messages=[{"role": "user", "content": "Draw a watercolour of a foggy harbor at dawn."}],
)

# resp.choices[0].message.content carries text + an image data URL or
# inline_data block, depending on the SDK's serialization. Inspect the
# raw response if your SDK doesn't surface the image directly.
لا يمكن استدعاء هذه النماذج عبر /v1/images/generations — استخدم chat completions معها.

انظر أيضًا