ForHosting KIT · Images

Créez une spécification d’image factice

Demandez une image factice de 640 × 360 et obtenez la taille du canevas, des couleurs écrites toujours de la même façon, comme #1A2B3C, et une étiquette « 640 × 360 » centrée en 320, 180. Réservez la place des images avant le visuel définitif. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Une spécification d’image factice est utile lorsqu’une mise en page exige une géométrie prévisible avant que le visuel définitif soit disponible. Indiquez une largeur et une hauteur positives en pixels, puis, si vous le souhaitez, les couleurs hexadécimales du fond et du texte. Le résultat décrit le canevas, les couleurs normalisées et un libellé de dimensions placé exactement au centre.

Définissez le canevas avant de construire l’interface

Commencez par la largeur et la hauteur exactes que l’image finale devra occuper. Ces deux valeurs sont exprimées en pixels et doivent être des entiers positifs, afin que la spécification convienne aux navigateurs, aux systèmes de conception et aux jeux de données de test courants. L’objet de dimensions renvoyé conserve ces valeurs sans mise à l’échelle ni supposition concernant le rapport d’aspect.

Le résultat constitue ainsi un contrat stable entre le système de contenu, qui connaît l’emplacement requis, et le moteur qui traduira ensuite la spécification en SVG, commandes de canevas, CSS ou autre format. Puisque cette capacité renvoie une description plutôt que des données binaires, vous gardez la maîtrise du type de fichier, de la compression, de la typographie et de l’environnement de rendu. Une carte peut demander un format paysage et un avatar un format carré, tout en recevant la même structure prévisible.

Les dimensions nulles, négatives, fractionnaires, absentes ou non numériques sont rejetées au lieu d’être corrigées silencieusement, ce qui empêche des données de mise en page erronées de poursuivre leur parcours.

Choisissez des couleurs hexadécimales canoniques

Les couleurs de fond et de texte sont facultatives. Si vous les omettez, la spécification adopte un fond gris clair neutre et un texte gris foncé, qui constituent des valeurs pratiques pour une image factice. Toute couleur fournie doit respecter la notation hexadécimale CSS à trois, quatre, six ou huit chiffres ; le signe dièse est facultatif.

Les formes courtes sont développées et les lettres converties en majuscules, de sorte que des entrées équivalentes aboutissent à une seule valeur canonique. Une forme courte et son équivalent à six chiffres ne créent donc pas inutilement des clés de cache ou des instantanés distincts. Les formes à quatre et huit chiffres conservent le canal alpha pour les moteurs compatibles avec la transparence.

La capacité refuse volontairement les noms de couleurs, dégradés, fonctions et jetons de conception, car ils dépendent d’un environnement stylistique donné et réduiraient la portabilité. Elle ne garantit pas non plus la conformité du contraste. Si la lisibilité compte, contrôlez les couleurs normalisées avant le rendu.

Les erreurs indiquent clairement le champ dont le format n’est pas accepté.

Affichez le libellé centré de manière cohérente

Le texte du libellé est produit directement à partir des dimensions validées, selon la forme habituelle largeur par hauteur. Sa coordonnée horizontale correspond à la moitié de la largeur et sa coordonnée verticale à la moitié de la hauteur ; une dimension impaire peut donc légitimement donner une coordonnée au demi-pixel. Des valeurs explicites d’alignement horizontal et vertical demandent au moteur d’ancrer le libellé en son centre, plutôt que d’interpréter les coordonnées comme une origine supérieure gauche.

La spécification n’impose ainsi aucune famille de caractères, taille, hauteur de ligne ou méthode de mesure du texte, qui relèvent de la couche de rendu. Un navigateur peut convertir les champs en attributs de texte SVG, tandis qu’une bibliothèque graphique côté serveur utilisera les mêmes coordonnées avec ses propres options de centrage. Seules la validation, la normalisation et l’arithmétique interviennent.

Aucun appel réseau, aucune horloge, aucune source aléatoire ni aucun état mémorisé ne modifie le résultat, ce qui convient aux tests visuels, à la documentation et aux données de démonstration.

Cas d’usage

Préparer des maquettes adaptatives

Créez des spécifications cohérentes pour les emplacements d’images des cartes, galeries et bannières avant la livraison des visuels.

Alimenter un moteur d’image interne

Normalisez les dimensions et les couleurs avant de convertir le résultat en SVG, commandes de canevas ou instructions graphiques serveur.

Stabiliser les tests visuels

Employez des coordonnées déterministes et des couleurs canoniques dans les instantanés sans dépendre d’un service d’images factices.

Questions fréquentes

Que se passe-t-il si les couleurs sont omises ?

Le fond prend la valeur #CCCCCC et le libellé #333333. Les deux figurent dans le résultat sous une forme normalisée à six chiffres.

Quels formats de couleur sont acceptés ?

Les couleurs CSS hexadécimales à trois, quatre, six ou huit chiffres sont admises, avec ou sans dièse initial.

Pourquoi une coordonnée centrale peut-elle être décimale ?

Le centre mathématique d’une dimension impaire se trouve entre deux pixels ; la division par deux produit donc correctement un demi-pixel.

Crée-t-il le fichier de l'image factice ?

Non. Il décrit le canevas, les couleurs et l'étiquette centrée sans dessiner, télécharger ni stocker la moindre image. Celui qui la produit garde la main sur le type de fichier, la compression et la typographie.

Vérifie-t-il que le texte reste lisible sur le fond ?

Non, il ne garantit pas qu'une paire de couleurs respecte une norme de contraste. Si la lisibilité compte, passez les deux couleurs normalisées dans un vérificateur de contraste avant de dessiner l'image factice.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/image/placeholder-image-spec

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/image/placeholder-image-spec \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":640,"height":360}'

const res = await fetch("https://api.kit.forhosting.com/image/placeholder-image-spec", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 640,
    "height": 360
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/placeholder-image-spec",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 640,
    "height": 360
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/placeholder-image-spec", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":640,"height":360}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":640,"height":360}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/placeholder-image-spec", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "width": 640,
  "height": 360
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.placeholder_image_spec",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_mb`	15
`max_megapixels`	12

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Il ne télécharge, ne produit et ne stocke aucune image : une même entrée fournit donc toujours le même JSON compact sans service distant.

Questions techniques

Cette capacité crée-t-elle un fichier image ?

Non. Elle renvoie une spécification JSON indépendante du moteur, décrivant le canevas, les couleurs, le texte et la position centrée du libellé.

Quel est le prix d’une requête API ?

Chaque requête API coûte $0.002. Le calcul ne fait appel à aucun service réseau externe.

Consulter la documentation complète du KIT →

Lancer gratuitement