flux-kontext-max API

المواصفات التقنية لـ flux-kontext-max

ما هو flux-kontext-max؟

flux-kontext-max هو معرّف CometAPI على المنصة لـ FLUX.1 Kontext [max] من Black Forest Labs، وهو نموذج صور متميز مصمم لكل من التوليد من النص إلى صورة وتحرير الصور ضمن نظام واحد. بدلاً من التعامل مع التوليد والتحرير كأدوات منفصلة، بُنيت عائلة Kontext لسير عمل ضمن السياق حيث يمكن للمستخدمين تقديم تعليمات نصية، مع إمكانية تضمين صورة اختياريًا، ثم صقل النتيجة أو تعديلها أو إعادة أسلوبها عبر عدة دورات.

يتموضع إصدار [max] كأعلى خيار جودة ضمن تشكيلة FLUX.1 Kontext. تصفه Black Forest Labs بأنه نموذج متميز بأقصى أداء، والتزام أقوى بالموجهات، وتوليد طباعة أقوى، واتساق متميز في التحرير، مع دعم سير عمل تكراري سريع.

عمليًا، يستهدف flux-kontext-max الفرق التي تحتاج إلى ما يتجاوز التوليف الأساسي للصور. وهو مفيد لمرئيات متسقة مع العلامة التجارية، وتحريرات تحافظ على الشخصية، وتغييرات موضعية على الصور القائمة، وإضفاء طابع أسلوبي، واستبدال النص داخل المشاهد مثل اللافتات والملصقات أو العناصر المرئية الشبيهة بواجهات المستخدم.

الميزات الرئيسية لـ flux-kontext-max

• توليد وتحرير موحَّدان: يدعم إنشاء الصور من الموجهات وتحرير الصور القائمة ضمن سير النموذج نفسه، ما يبسط تصميم التطبيقات لأدوات الإبداع وخطوط الإنتاج.
• طبقة Kontext بأقصى جودة: إصدار [max] هو العرض المتميز ضمن FLUX.1 Kontext، موجه لأفضل جودة مخرجات، والتزام أقوى بالموجه، واتساق أعلى في التحرير.
• اتساق الشخصية: مصمم للحفاظ على الهوية والسمات البصرية المميزة عبر مشاهد متعددة وتحريرات تكرارية، وهو ما يفيد في السرد القصصي وأصول التسويق وحملات متعددة الصور.
• تحرير موضعي دقيق: يمكنه تعديل أجزاء محددة من الصورة مع الحفاظ على التركيب المحيط، مما يمكّن من استبدال كائنات مستهدف، وضبط المشهد، أو تنظيف انتقائي.
• تحويل المشهد ضمن السياق: يتيح للمطورين تحويل عناصر من صورة قائمة مع إبقاء علاقتها بالمشهد الأوسع متماسكة، بدل إعادة توليد المشهد بالكامل بشكل أعمى.
• قوة في الطباعة وتحرير النص: تشير Black Forest Labs إلى تحسين في توليد الطباعة، وتذكر وثائق المساعدة بوضوح تحرير النص واستبداله في اللافتات والملصقات كقدرة رئيسية.
• نسب أبعاد مرنة بمخرج ثابت 1 ميغابكسل: يتم توليد المخرجات بدقة ثابتة قدرها 1 ميغابكسل مع مرونة في اختيار نسب الأبعاد لأسطح المنتجات والتنسيقات الإبداعية المختلفة.
• تسعير متوقع لكل صورة: تسعّر Black Forest Labs النموذج عند 8 أرصدة أو $0.08 لكل صورة، ما يجعل تقدير التكلفة مباشرًا لعمليات التوليد والتحرير الدفعي.

كيفية الوصول إلى flux-kontext-max ودمجه

الخطوة 1: التسجيل للحصول على مفتاح API

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

الخطوة 2: إرسال الطلبات إلى واجهة flux-kontext-max

بعد الحصول على مفتاح API، أرسل الطلبات إلى نقطة نهاية CometAPI المتوافقة مع OpenAI واضبط حقل model إلى flux-kontext-max.

curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header "Authorization: Bearer $COMETAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "flux-kontext-max",
    "prompt": "Create a cinematic product-style image of a smartwatch on a reflective black surface with dramatic studio lighting"
  }'

يمكنك أيضًا دمجه باستخدام صيغة OpenAI SDK:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_API_KEY,
  baseURL: "https://api.cometapi.com/v1"
});

const result = await client.images.generate({
  model: "flux-kontext-max",
  prompt: "Create a cinematic product-style image of a smartwatch on a reflective black surface with dramatic studio lighting"
});

console.log(result);

الخطوة 3: استرجاع النتائج والتحقق منها

بعد الإرسال، حلّل استجابة الواجهة واسترجع الصورة المولدة التي تعيدها المنصة. ينبغي بعد ذلك التحقق من جودة المخرجات، والالتزام بالموجه، وأي تحريرات مطلوبة أو تفاصيل ط typographic قبل استخدام النتيجة في سير العمل الإنتاجي. وللاستخدام واسع النطاق، ضع في الاعتبار سلوك التزامن لدى المزوّد؛ توثّق Black Forest Labs حدًا قدره 6 مهام نشطة لـ flux-kontext-max.