Synchrone et asynchrone en un seul appel
Les modèles d'image rapides répondent immédiatement ; les vidéos s'exécutent en asynchrone via webhook ou interrogation — même client, une seule méthode.
Vérification des webhooks intégrée
Vérification HMAC-SHA256 avec horodatage anti-rejeu. Une ligne de code, sûre dès l'installation.
À l'écoute des limites de débit
Chaque réponse expose les en-têtes X-RateLimit-* sous forme d'objets déjà analysés, en cas de succès COMME d'erreur. Ajustez votre cadence avant le 429.
Zéro dépendance
Le SDK JS s'appuie sur fetch natif + Web Crypto. Le SDK PHP utilise curl + ext-hash. À déposer dans n'importe quel environnement.
SDK disponibles
Choisissez le langage le plus proche de votre stack — tous les SDK exposent la même surface, le modèle mental se transpose donc directement.
Installation
npm install @flixly/sdkDémarrage rapide
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/...Vérifier les 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();Installation
composer require flixly/sdkDémarrage rapide
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()}");
}Vérifier les 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;
}Intégrations sans code
Branchez Flixly sur vos outils d'automatisation existants — n8n, WordPress, Shopify et bien d'autres. Aucune installation de SDK requise.
Parcourir les plugins de plateformesAutres façons d'appeler l'API
Vous développez dans un langage pour lequel nous ne publions pas de SDK ? Appelez directement l'API REST — la spécification complète, lisible par machine, est ci-dessous.
À importer dans Postman, n8n, Make ou l'outil de génération de code de votre choix.
Documentation endpoint par endpoint, authentification, limites de débit, codes d'erreur.
Format des événements, vérification de signature HMAC, politique de relance. Fini l'interrogation.
Émettez des clés avec un plafond de dépense par clé et des URL de webhook par défaut.