المتزامن وغير المتزامن في نداء واحد
نماذج الصور السريعة تُرجع النتيجة فورًا، أما الفيديو فيُنفَّذ بشكل غير متزامن عبر webhook أو بالاستطلاع — العميل نفسه، وطريقة واحدة.
تحقّق مدمج من الـ webhooks
تحقّق بخوارزمية HMAC-SHA256 مع طوابع زمنية تمنع إعادة الإرسال. سطر واحد من الشيفرة، وأمان جاهز فور الاستخدام.
مُدرِك لحدود المعدّل
كل استجابة تُظهر ترويسات X-RateLimit-* ككائنات محلَّلة مسبقًا، في حالات النجاح وفي حالات الخطأ أيضًا. نظِّم وتيرتك قبل أن تصطدم بالخطأ 429.
بلا أي اعتماديات
حزمة JS تعتمد على fetch الأصلية وWeb Crypto، وحزمة PHP تعتمد على curl وext-hash. تعمل في أي بيئة.
حِزم SDK المتاحة
اختر اللغة الأقرب إلى بيئتك التقنية — كل حزمة SDK تعرض الواجهة نفسها، فينتقل معك النموذج الذهني كما هو.
التثبيت
npm install @flixly/sdkبداية سريعة
import { Flixly } from "@flixly/sdk";
const flixly = new Flixly({ apiKey: process.env.FLIXLY_API_KEY! });
const result = await flixly.generateAndWait({
model: "flux-dev",
prompt: "A cat wearing a top hat, oil painting style",
type: "TEXT_TO_IMAGE",
input: { aspect_ratio: "1:1", resolution: "1K" },
});
console.log(result.data.output_url);
// → https://cdn.flixly.ai/outputs/...التحقّق من الـ webhooks
// Verify incoming webhooks in your handler
import { Flixly } from "@flixly/sdk";
const valid = await Flixly.verifyWebhookSignature({
secret: process.env.FLIXLY_WEBHOOK_SECRET!,
timestamp: req.headers["x-flixly-timestamp"]!,
signature: req.headers["x-flixly-signature"]!,
body: rawBody, // raw, NOT JSON.parse + re-stringify
});
if (!valid) return res.status(401).end();التثبيت
composer require flixly/sdkبداية سريعة
use Flixly\Flixly;
use Flixly\FlixlyError;
$flixly = new Flixly(['api_key' => getenv('FLIXLY_API_KEY')]);
try {
$gen = $flixly->generateAndWait([
'model' => 'flux-dev',
'prompt' => 'A cat wearing a top hat, oil painting style',
'type' => 'TEXT_TO_IMAGE',
'input' => ['aspect_ratio' => '1:1', 'resolution' => '1K'],
]);
echo $gen['data']['output_url'];
// → https://cdn.flixly.ai/outputs/...
} catch (FlixlyError $e) {
error_log("Flixly: {$e->getErrorCode()} {$e->getMessage()}");
}التحقّق من الـ webhooks
// Verify incoming webhooks in your handler
$body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_FLIXLY_SIGNATURE'] ?? '';
$timestamp = $_SERVER['HTTP_X_FLIXLY_TIMESTAMP'] ?? '';
$valid = Flixly::verifyWebhookSignature(
getenv('FLIXLY_WEBHOOK_SECRET'),
$timestamp,
$signature,
$body // raw body — do NOT json_decode + re-encode
);
if (!$valid) {
http_response_code(401);
exit;
}تكاملات بلا برمجة
أضِف Flixly إلى أدوات الأتمتة التي تستخدمها بالفعل — n8n وWordPress وShopify وغيرها. من دون تثبيت أي SDK.
تصفّح إضافات المنصّاتطرق أخرى لاستدعاء الواجهة البرمجية
تبني مشروعك بلغة لا نوفّر لها حزمة SDK؟ استدعِ واجهة REST مباشرةً — المواصفة الكاملة القابلة للقراءة آليًا متاحة أدناه.
استوردها إلى Postman أو n8n أو Make أو أي أداة لتوليد الشيفرة تفضّلها.
توثيق لكل نقطة نهاية على حدة، مع المصادقة وحدود المعدّل ورموز الأخطاء.
بنية الأحداث، والتحقّق من توقيع HMAC، وسياسة إعادة المحاولة. استغنِ عن الاستطلاع.
أصدِر مفاتيح بسقف إنفاق لكل مفتاح وعناوين webhook افتراضية.