ForHosting KIT · Outils pour développeurs

Calculateur de longueur de fil pour perles

Ce calculateur estime l’espace linéaire occupé par les perles et les intercalaires avant que vous ne coupiez le cordon ou le fil.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez le nombre de perles identiques, leur diamètre en millimètres et la largeur de chaque intercalaire du motif. L’outil additionne les deux longueurs, puis donne la longueur nécessaire en millimètres, centimètres et pouces. Vous pouvez ainsi préparer une séquence répétée, comparer plusieurs tailles de perles et vérifier si le motif correspondra à la taille prévue d’un collier ou d’un bracelet.

Mesurez la dimension qui suit le fil

Utilisez la dimension de la perle parallèle au trou, car elle représente l’espace occupé après l’enfilage. Une perle ronde de 8 mm ajoute généralement environ 8 mm, tandis qu’une forme ovale, tubulaire ou irrégulière peut présenter une longueur de trou à trou différente de sa plus grande largeur visible. Mesurez un échantillon au pied à coulisse lorsque la précision compte. Saisissez le nombre de perles identiques et cette mesure longitudinale comme diamètre. Le calculateur multiplie ces valeurs pour obtenir la longueur des seules perles. Il suppose que les composants voisins se touchent, sans intervalle volontaire. Les nœuds, cache-écraseurs, protections de câble, fermoirs, chaînettes d’extension et portions visibles du cordon ne sont pas estimés. Mesurez tout élément supplémentaire et ajoutez-le comme intercalaire ou séparément à la longueur de coupe.

Saisissez des intercalaires variés sans moyenne

La liste accepte une largeur pour chaque intercalaire physique du motif. Si la composition comprend six rondelles métalliques de 2 mm et deux séparateurs centraux de 4 mm, saisissez six fois 2 et deux fois 4. Le détail de chaque pièce évite les erreurs de comptage et d’arrondi provoquées par une moyenne. Laissez la liste vide si le motif ne comporte aucun intercalaire. Une largeur nulle est admise comme repère, mais son omission reste plus claire. Le résultat indique le nombre d’intercalaires et leur longueur cumulée afin que vous puissiez contrôler la disposition avant l’achat ou la coupe. Mesurez toujours dans l’axe du fil, et non sur la face décorative. Une calotte qui recouvre partiellement une perle peut ajouter moins que sa largeur annoncée ; montez alors un court échantillon pour mesurer l’allongement réel.

Passez de la longueur occupée à la longueur de coupe

La longueur affichée correspond à l’espace des composants, pas automatiquement à la quantité de cordon ou de câble à couper. Comparez-la d’abord à la taille finie souhaitée. Sur un collier ou un bracelet fermé, le fermoir peut ajouter de la longueur, alors que les écraseurs, boucles, nœuds et extrémités exigent une réserve qui ne reste pas dans la circonférence visible. Le bijou souple suit aussi une courbe : de grosses perles peuvent réduire la circonférence intérieure, surtout sur un bracelet ajusté. Réalisez un échantillon ou utilisez un triboulet si l’ajustement est essentiel. Ajoutez ensuite les marges conseillées pour votre fermoir et votre technique. Les centimètres résultent d’une division des millimètres par dix, et les pouces d’une division par 25.4. Les valeurs sont arrondies à six décimales. Chaque calcul par API coûte $0.002.

Cas d’usage

Préparer un bracelet

Contrôlez l’espace des perles et intercalaires avant d’ajouter le fermoir et les marges de finition.

Comparer les diamètres

Observez l’effet du passage de perles de 6 mm à des perles de 8 mm sur la même composition.

Vérifier un motif de collier

Distinguez les longueurs des perles et des intercalaires pour repérer une pièce oubliée ou doublée.

Questions fréquentes

Le résultat comprend-il le fermoir ?

Uniquement si vous saisissez sa largeur effective dans l’axe du fil comme intercalaire. Sinon, ajoutez séparément le fermoir et les marges de finition.

Quelle mesure de perle faut-il saisir ?

Saisissez la distance de trou à trou dans l’axe du fil. Pour une perle ronde, elle correspond généralement au diamètre annoncé.

Comment saisir deux tailles d’intercalaires ?

Ajoutez une valeur par intercalaire physique, en millimètres. Répétez la valeur pour chaque pièce identique.

Puis-je calculer un motif sans intercalaire ?

Oui. Omettez spacer_sizes_mm ou fournissez une liste vide ; seules les perles détermineront alors le total.

Cet outil calcule-t-il la longueur de cordon à couper ?

Il calcule l’espace des composants. Ajoutez la réserve nécessaire aux nœuds, écraseurs, boucles, extrémités et finitions.

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/hobby/craft-bead-strand-length

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/hobby/craft-bead-strand-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bead_count":24,"bead_diameter_mm":8}'

const res = await fetch("https://api.kit.forhosting.com/hobby/craft-bead-strand-length", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "bead_count": 24,
    "bead_diameter_mm": 8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/hobby/craft-bead-strand-length",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "bead_count": 24,
    "bead_diameter_mm": 8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/craft-bead-strand-length", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"bead_count":24,"bead_diameter_mm":8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"bead_count":24,"bead_diameter_mm":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/craft-bead-strand-length", 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

{
  "bead_count": 24,
  "bead_diameter_mm": 8
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "hobby.craft_bead_strand_length",
  "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.

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.

Consulter la documentation complète du KIT →