API documentation

Generate AI images from your own application with our REST API.

Authentification

Toutes les requêtes nécessitent une clé API, générée depuis votre espace membre. Transmettez-la dans l'en-tête Authorization.

Authorization: Bearer fia_votre_cle_api

URL de base : https://test.creatorkit.online/api/v1 · Limite : 60 requêtes/minute.

POST /generate

ParamètreTypeDescription
promptstringObligatoire. Description de l'image (3 à 1500 caractères).
negative_promptstringÉléments à éviter.
engine_idintIdentifiant du moteur (voir /engines).
sizestringPar exemple 1024x1024.
countint1 à 4.
stylestringSlug de style, par exemple cinematic.
is_publicboolPublier dans la galerie publique.

Exemple cURL

curl -X POST https://test.creatorkit.online/api/v1/generate \
  -H "Authorization: Bearer fia_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a lighthouse in a storm, cinematic","size":"1024x1024","count":1}'

Réponse

{
  "success": true,
  "images": [
    {
      "id": 128,
      "uuid": "a1b2c3d4e5f6a7b8c9d0e1f2",
      "url": "https://test.creatorkit.online/uploads/images/2026/01/a1b2c3.png",
      "width": 1024,
      "height": 1024
    }
  ],
  "credits": 42,
  "duration": 6.4,
  "engine": "Flux Schnell"
}

Exemple PHP

<?php
$ch = curl_init('https://test.creatorkit.online/api/v1/generate');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer fia_votre_cle_api',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'prompt' => 'a lighthouse in a storm, cinematic',
        'size'   => '1024x1024',
        'count'  => 1,
    ]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data['images'][0]['url'];

Exemple JavaScript

const res = await fetch('https://test.creatorkit.online/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fia_votre_cle_api',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ prompt: 'a lighthouse in a storm', count: 1 })
});
const data = await res.json();
console.log(data.images[0].url);

POST /enhance

Améliore une description courte. Corps : {"prompt":"un chat astronaute"}.

GET /engines

Liste les moteurs disponibles avec leur coût en crédits et les formats acceptés.

IDMoteurCréditsFormats
1 Turbo (gratuit) 1 1024x1024, 1024x1792, 1792x1024, 1280x720

GET /account

Renvoie votre solde de crédits, votre offre et le nombre d'images générées.

GET /images

Liste paginée de vos images : paramètre page, 50 résultats par page.

Codes d'erreur

CodeSignification
401Clé API absente, invalide ou révoquée.
422Paramètre invalide, crédits insuffisants ou description refusée.
429Limite de requêtes atteinte.
503API désactivée par l'administrateur.

Create a key