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ètre | Type | Description |
|---|---|---|
prompt | string | Obligatoire. Description de l'image (3 à 1500 caractères). |
negative_prompt | string | Éléments à éviter. |
engine_id | int | Identifiant du moteur (voir /engines). |
size | string | Par exemple 1024x1024. |
count | int | 1 à 4. |
style | string | Slug de style, par exemple cinematic. |
is_public | bool | Publier 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.
| ID | Moteur | Crédits | Formats |
|---|---|---|---|
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
| Code | Signification |
|---|---|
401 | Clé API absente, invalide ou révoquée. |
422 | Paramètre invalide, crédits insuffisants ou description refusée. |
429 | Limite de requêtes atteinte. |
503 | API désactivée par l'administrateur. |