المواصفات التقنية لـ ideogram-ai/ideogram-v2
| المواصفة | التفاصيل |
|---|---|
| Model ID | ideogram-ai/ideogram-v2 |
| Provider / family | نموذج توليد الصور Ideogram 2.0. تشير Ideogram إلى أن الإصدار 2.0 صدر في 21 أغسطس 2024. |
| Modality | توليد نص-إلى-صورة، مع دعم مرتبط في V2 لسير عمل تحرير الصور ضمن عائلة واجهات Ideogram. |
| Input type | مطالبات باللغة الطبيعية، مع ضوابط اختيارية مثل نسبة الأبعاد، البذرة، عدد الصور، وخيارات تحسين المطالبة ضمن منظومة واجهات Ideogram. |
| Output type | صور مولدة تُعاد ككائنات صور/روابط URL في استجابة واجهة البرمجة. تشير Ideogram إلى أن روابط الصور محدودة الزمن ويجب تنزيلها إذا كنت بحاجة للاحتفاظ بها. |
| Common controls | تدعم واجهات توليد Ideogram عبر نقاط النهاية المختلفة إعداد البذرة للقابلية لإعادة الإنتاج، إخراج صور متعددة، التوجيه السلبي، سرعة التصيير، واختيار نسبة الأبعاد؛ وقد تختلف المعاملات المعروضة بدقة بحسب نقطة النهاية الموجهة. |
| Aspect ratios / dimensions | توثّق Ideogram عدة نسب أبعاد مضبوطة مسبقاً للإصدار v2.0، مع دقات افتراضية خاصة بالنموذج مثل 1:1، 9:16، 16:9، وغيرها من صيغ الوضعين العمودي/الأفقي. |
| Editing compatibility | تشير وثائق واجهة /edit من Ideogram إلى أن التحرير مدعوم لـ V_2 و V_2_TURBO. |
| API style | متاحة عبر نمط واجهة متوافق مع OpenAI لدى CometAPI باستخدام مفتاح CometAPI وتجاوز Base URL. (cometapi.com) |
ما هو ideogram-ai/ideogram-v2؟
ideogram-ai/ideogram-v2 هو معرّف المنصة لدى CometAPI لنموذج الصور Ideogram 2.0، وهو نظام نص-إلى-صورة من Ideogram مصمم لتوليد مرئيات عالية الجودة من مطالبات باللغة الطبيعية. تضع وثائق Ideogram الرسمية الإصدار 2.0 كنموذج توليد رئيسي ضمن تشكيلتها، بين إصدار 1.0 الأقدم والإصدارات اللاحقة 2a و 3.0.
عملياً، يناسب هذا النموذج المطورين الذين يريدون تحويل المطالبات المكتوبة إلى صور مصقولة للاستخدام في المواد التسويقية، فنون المفاهيم، الملصقات، صور المنتجات، المحتوى الاجتماعي، وغيرها من مسارات العمل كثيفة التصميم. وبناءً على وثائق واجهات Ideogram، فإن عائلة V2 الأوسع تدعم أيضاً سير عمل أكثر قابلية للتحكم مثل التحرير، ما يجعلها خياراً قوياً عند الحاجة إلى جودة توليد عالية وإمكانية التكرار الموجه بالطلبات.
ومن السمات البارزة لنماذج Ideogram تركيزها على إعدادات توليد قابلة للتحكم، بما في ذلك خيارات نسبة الأبعاد، القابلية لإعادة الإنتاج عبر البذور، خيارات سرعة التصيير، وميزات مساعدة المطالبة. وهذا يجعل ideogram-ai/ideogram-v2 مفيداً ليس فقط لإنشاء صورة لمرة واحدة، بل أيضاً لخطوط الإنتاج التي تتطلب اتساقاً وقابلية تكرار.
الميزات الرئيسية لـ ideogram-ai/ideogram-v2
- توليد نص-إلى-صورة عالي الجودة: النموذج مبني لتوليد الصور مباشرة من مطالبات باللغة الطبيعية، ما يتيح إنشاءً سريعاً للرسومات، الأعمال الفنية المعنونة، المشاهد، ومفاهيم التصميم.
- التحكم بالمطالبة والقابلية لإعادة الإنتاج: تدعم Ideogram معاملات البذور، ما يساعد على إعادة إنتاج النتائج أو تكرارها بشكل منهجي أثناء التجريب والاستخدام في الإنتاج.
- نسب أبعاد مرنة: يدعم الإصدار 2.0 مجموعة واسعة من نسب الأبعاد والدقات المحددة مسبقاً، ما يجعله عملياً للمخرجات المربعة، العمودية، الأفقية، اللافتات، ولأغراض الأجهزة المحمولة.
- توليد صور متعددة: تدعم واجهة Ideogram طلب أكثر من صورة في الاستدعاء الواحد، وهو مفيد لاستكشاف المطالبات، اختبارات A/B، ومسارات انتقاء الأعمال الإبداعية.
- دعم تحرير الصور ضمن عائلة V2: توضح نقطة تحرير Ideogram صراحةً دعم V_2 و V_2_TURBO، ما يشير إلى أن عائلة توليد V2 مناسبة للإنشاء والتعديل معاً.
- خيارات سرعة التصيير: توثق Ideogram ضوابط سرعة التصيير التي توازن بين السرعة والتفاصيل، لمساعدة الفرق على تحسين العمل إما للتكرار السريع أو للدقة الأعلى.
- خيارات تحسين المطالبة: تتضمن واجهات Ideogram عناصر Magic Prompt، التي يمكنها إثراء المطالبات تلقائياً وتحسين جودة المخرجات عند الحاجة.
- تكامل واجهة برمجة تطبيقات ملائم للمطورين: عبر CometAPI، يمكن استدعاء النموذج باستخدام نمط تكامل متوافق مع OpenAI، ما يقلل جهد الانتقال للفرق التي تستخدم عملاء بأسلوب OpenAI. (cometapi.com)
كيفية الوصول إلى ودمج ideogram-ai/ideogram-v2
الخطوة 1: التسجيل للحصول على مفتاح API
سجّل الدخول إلى CometAPI وأنشئ رمز API في لوحة التحكم. توفر CometAPI نمط وصول متوافقاً مع OpenAI، لذا يمكنك استخدام مفتاح CometAPI كبيانات اعتماد للطلبات الموجهة إلى ideogram-ai/ideogram-v2. (cometapi.com)
الخطوة 2: إرسال الطلبات إلى واجهة ideogram-ai/ideogram-v2
استخدم نقطة نهاية CometAPI، ضَع مفتاح API في ترويسة Authorization، وعيّن الحقل model إلى ideogram-ai/ideogram-v2.
curl --request POST \
--url https://api.cometapi.com/v1/images/generations \
--header "Authorization: Bearer YOUR_COMETAPI_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "ideogram-ai/ideogram-v2",
"prompt": "A cinematic product photo of a premium coffee bag on a wooden table, warm morning light, realistic style"
}'
يمكنك أيضاً استخدام عميل متوافق مع OpenAI عبر توجيه عنوان الأساس (base URL) إلى CometAPI وتمرير ideogram-ai/ideogram-v2 كمُعرّف النموذج. توثّق CometAPI نمط تجاوز عنوان الأساس لهذا التكامل المتوافق. (cometapi.com)
الخطوة 3: استرجاع النتائج والتحقق منها
قم بتحليل استجابة JSON واستخرج عنوان URL للصورة المولدة أو بيانات الصورة المعادة. نظراً لأن Ideogram تشير إلى أن روابط الصور قد تكون متاحة لفترة محدودة، فاحرص على تنزيل النتائج أو الاحتفاظ بها بسرعة إذا كنت تحتاج للوصول إليها على المدى الطويل. بعد ذلك، تحقّق من توافق المخرجات مع المطالبة، الجودة البصرية، نسبة الأبعاد، وأي متطلبات لعرض النص داخل الصور ضمن سير عمل تطبيقك.