💼 Flixy Business · API v1

L'API Flixy, en 5 minutes

Une API REST simple, en JSON : envoyez une requête avec votre clé, récupérez votre création sans filigrane.

Créez une clé

Studio → Business Suite → API → « Créer une clé ». Elle n'est affichée qu'une fois : gardez-la secrète, côté serveur.

Lancez une création

POST generate.php avec un format et un prompt. La réponse arrive tout de suite avec un identifiant.

Récupérez le fichier

Interrogez status.php toutes les 3 secondes. Quand le statut est « done », téléchargez « url ».

Authentification

Adresse de base : https://flixy.design/api/v1/

Authorization: Bearer flx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

L'en-tête « X-Api-Key » est aussi accepté. Limite : 60 requêtes par minute et par clé. Les créations sont payées en crédits avec votre remise Business ; une création qui échoue est remboursée.

Exemples

curl -X POST https://flixy.design/api/v1/generate.php \
  -H "Authorization: Bearer $FLIXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format":"reel_video","prompt":"A runner smiles at sunrise"}'

Points d'accès

POST/api/v1/generate.php

Lancer une création (image, retouche ou vidéo)

Requête
{
  "format": "native_square",
  "prompt": "A smiling runner at sunrise on a city bridge",
  "type": "image",
  "params": { "image_size": "2K" },
  "enhance": true
}
Réponse
{
  "ok": true,
  "id": 1842,
  "status": "queued",
  "type": "image",
  "format": "native_square",
  "credits_charged": 0.29,
  "balance": 412.5,
  "status_url": "https://flixy.design/api/v1/status.php?id=1842"
}
GET/api/v1/status.php?id=1842

Suivre une création ; « url » donne le fichier final sans filigrane

Réponse
{
  "ok": true,
  "id": 1842,
  "type": "image",
  "status": "done",
  "url": "https://flixy.design/api/v1/file.php?id=1842&exp=…&sig=…",
  "width": 2048,
  "height": 2048
}
POST/api/v1/copy.php

Générer des textes pub en plusieurs variantes

Requête
{
  "kind": "push",
  "brief": "Meditation app, 7-day free trial, busy professionals",
  "lang": "en",
  "variants": 3,
  "tone": "warm",
  "brand": "Calmly"
}
Réponse
{
  "ok": true,
  "kind": "push",
  "items": [
    { "title": "Breathe. Just 3 minutes.", "message": "Your 7-day free trial is ready.", "image_prompt": "…" }
  ],
  "credits_charged": 0.06,
  "balance": 412.44
}
POST/api/v1/svg.php

Créer une bannière SVG animée

Requête
{
  "brief": "Winter sale -40% on sneakers",
  "width": 300,
  "height": 250,
  "colors": "#FF80BF, #1E1A24",
  "cta": "Shop now",
  "lang": "en"
}
Réponse
{
  "ok": true,
  "width": 300,
  "height": 250,
  "svg": "<svg xmlns=…>…</svg>",
  "credits_charged": 0.12
}
GET/api/v1/balance.php

Solde de crédits et remise du compte

Réponse
{
  "ok": true,
  "account": "Acme Inc.",
  "balance": 412.44,
  "discount_percent": 20,
  "credit_usd": 1
}
GET/api/v1/formats.php

Liste des formats pub et des types de textes

Réponse
{ "ok": true, "formats": [ … ], "copy_kinds": [ … ] }

Champs de generate.php

ChampDescription
prompt *Description de la création (3 à 2 000 caractères), dans n'importe quelle langue.
formatFormat pub (voir la liste ci-dessous) : règle le cadrage, la durée et les consignes pub.
typeimage · edit · video
paramsaspect_ratio, image_size (1K, 2K, 4K), style, lighting · vidéo : resolution (720p, 1080p), duration (4s–10s)
imagePhoto en base64 (PNG, JPEG, WebP, 12 Mo max) : à retoucher (edit) ou à animer (video).
continue_fromIdentifiant d'une création terminée à modifier ou à prolonger.
enhancetrue : l'assistant Flixy améliore le prompt avant la création.

Formats pub

formatNomTypeTaille de diffusion
native_squareNative ad carréeimage1200×1200
native_wideNative ad paysageimage1200×628
push_iconIcône pushimage192×192
push_imageImage pushimage720×480
banner_mrecBannière pavé 300×250image300×250
banner_leaderBannière horizontale 728×90image728×90
banner_skyBannière verticale 160×600image160×600
social_feedPub Facebook / Instagramimage1080×1350
social_storyStory sponsoriséeimage1080×1920
reel_videoReel / TikTok publicitairevideo1080×1920 · 8s
ctv_videoSpot CTV / TV connectéevideo1920×1080 · 10s
social_squarePub LinkedIn / B2Bimage1200×1200
pin_verticalÉpingle Pinterestimage1000×1500
instream_videoPré-roll YouTube / in-streamvideo1920×1080 · 6s
dooh_portraitÉcran abribus / mobilier urbainimage1080×1920
dooh_landscapeÉcran géant / billboard digitalimage1920×1080
billboard_4x3Affiche 4×3 / panneauimage4×3 m
dooh_videoVidéo DOOH (gares, centres commerciaux)video1080×1920 · 8s
film_wideScène de film 16:9video1920×1080 · 8s
film_verticalScène de film vertical 9:16video1080×1920 · 8s
packshotPhoto produit carréeimage2048×2048
packshot_portraitPhoto produit portraitimage1600×2000
poster_portraitAffiche verticaleimageA3 / A4
poster_landscapeAffiche horizontaleimageA3 / A4
advertorialImage d'advertorialimage1600×900

Types de textes (champ « kind » de copy.php) : native push facebook tiktok banner ctv advertorial titles email

Erreurs

{ "ok": false, "error": { "code": "insufficient_credits", "message": "Not enough credits for this creation." } }
401 missing_key · invalid_keyClé absente, invalide ou supprimée.
402 insufficient_creditsSolde insuffisant : rechargez vos crédits.
403 not_businessLe compte n'a pas l'accès Business.
422 refusedDemande contraire aux règles d'utilisation.
429 rate_limitedPlus de 60 requêtes en une minute.

Une question technique ? Le support Business répond 24 h/24, 7 j/7 : business@flixy.design.

Ta prochaine publication commence ici

Crée gratuitement l'image, la retouche ou la vidéo de ton prochain post, au bon format pour chaque réseau.