Skip to main content

النماذج الشائعة


نظرة عامة

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

بيئة تجريب تفاعلية

فيما يلي مثال كامل بلغات مختلفة:
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const result = await krea.subscribe("image/bfl/flux-1-dev", {
  input: {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576,
    steps: 28
  }
});

console.log(`Image ready: ${result.data?.urls[0]}`);
استبدل بمفتاح API الخاص بكلاستبدال العنصر النائب YOUR_API_TOKEN في الأمثلة السابقة، ستحتاج إلى إنشاء رمز API من krea.ai/settings/api-tokens. اتبع التعليمات في صفحة مفاتيح API والفوترة إذا احتجت إلى مساعدة.
للاطلاع على جميع النماذج المتاحة، راجع صفحة واجهات API للنماذج.

تحليل تفصيلي

فيما يلي، سنرشدك عبر سير العمل الكامل بدءًا من إرسال طلب التوليد وحتى استرداد الصورة النهائية.

الخطوة 1: إنشاء مهمة توليد صورة

أرسل طلب POST إلى /generate/image/bfl/flux-1-dev مع نصك الوصفي والمعلمات. تُرجع الواجهة معرّف المهمة فورًا — يجري التوليد بشكل غير متزامن.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576,
  steps: 28
});

console.log(`Job ID: ${job.job_id}`);
مثال على الاستجابة
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

الخطوة 2: الاستعلام عن النتائج

استعلم عن /jobs/{job_id} كل ثانيتين حتى تكتمل المهمة. تُوفّر Krea API مخرجات توليد وسيطة لبعض النماذج.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const completed = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return completed.result.urls[0];
}

const imageUrl = await waitForJob(job.job_id);
console.log(`Image ready: ${imageUrl}`);
الويب هوك متاح!قم بإعداد الويب هوك لتلقّي إشعارات عند اكتمال المهام. راجع دليل الويب هوك للبدء.
للاطلاع على قائمة تفصيلية بالمعلمات لجميع النماذج، راجع صفحة واجهات API للنماذج.
مثال على استجابة مكتملة
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:25.000Z",
  "result": {
    "urls": [
      "https://krea.ai/generations/your-image.png"
    ]
  }
}
للاطلاع على جميع حالات المهام الممكنة ودورة حياتها الكاملة، راجع صفحة دورة حياة المهمة.