Calculadora de substituição de fios
Uma receita que pede 1200 jardas usa 6 novelos de 220 jardas, mas 7 de 180, porque 1200 dividido por 180 dá seis e dois terços. Informe a metragem e o comprimento dos novelos e compre o suficiente. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Metragem
- 1.200
- Comprimento do novelo
- 220
- Comprimento do novelo substituto
- 180
- Novelos originais
- 6
- Novelos substitutos
- 7
- Razão de comprimentos
- 1,2222222222
Trocar de marca ou de espessura de fio é uma decisão diária para quem tricota e crocheta e não consegue comprar exatamente o novelo que a receita indica. Esta calculadora de substituição de fios recebe a metragem total da receita, o comprimento do novelo original e o comprimento de cada novelo substituto, e devolve quantos novelos substitutos você precisa comprar usando uma divisão com arredondamento para cima transparente. Comprimento de novelo zero é rejeitado como entrada inválida, para que falhas de formulário nunca dividam por zero nem inventem um estoque infinito e gratuito de fio.
Como a quantidade de novelos substitutos é calculada a partir da metragem e dos comprimentos
O número de novelos substitutos a comprar é o teto da metragem da receita dividida pelo comprimento do novelo substituto. Se um suéter precisa de mil e duzentas jardas e cada novelo substituto tem cento e oitenta jardas, você precisa de sete novelos, porque mil e duzentos dividido por cento e oitenta dá seis e dois terços, e fio é vendido em unidades inteiras. A mesma identidade funciona em jardas ou em metros, desde que todos os campos usem uma única unidade coerente.
Comprimento de novelo zero ou negativo é erro duro pelo contrato do produto, porque dividiria por zero ou inverteria o sentido de uma meada. Comprimento de substituto zero ou negativo também é rejeitado. Metragem negativa é inválida; metragem zero resulta em zero novelos para projetos vazios ou descontinuados.
Casos de uso
Estoque e listas de compras
Quem faz artesanato converte a metragem total da receita e a apresentação de um novelo novo numa contagem inteira de novelos, para que carrinhos e listas de compras comprem fio suficiente sem faltar.
Ferramentas para lojas de fios e marketplaces
Lojas e marketplaces de artesanato estimam contagens de novelos substitutos quando um cliente troca de marca, ajudando a equipe a responder “quantos destes eu preciso?” no balcão.
Editoras de receitas e planejadores de projetos
Editoras e aplicativos de planejamento mostram contagens de novelos originais e substitutos lado a lado quando leitores adaptam um modelo a outro comprimento de meada ou espessura.
Perguntas frequentes
A metragem e os comprimentos dos novelos precisam da mesma unidade?
Sim. Use jardas em tudo ou metros em tudo. A calculadora não converte unidades; sistemas misturados produzem contagens erradas, mesmo que a aritmética funcione.
A calculadora de substituição de fios é gratuita?
A ferramenta do navegador roda grátis no seu dispositivo.
Por que o resultado sempre arredonda para cima?
Porque o fio é vendido em novelos inteiros. Se a receita pede 1200 jardas e cada novelo novo tem 180, a conta exata dá seis e dois terços, então você precisa comprar 7 para não faltar fio.
Um fio da mesma espessura tem sempre a mesma metragem?
Não. Dois novelos da mesma espessura podem ter comprimentos diferentes quando a densidade da fibra muda. Use o comprimento impresso em cada etiqueta, não a espessura, ao informar os novelos.
Ela confere a amostra de tensão ou o lote de tingimento?
Não. Ela só conta quantos novelos cobrem o comprimento necessário. Não converte unidades, não confere sua amostra nem combina lotes de tingimento, então faça uma amostra antes de decidir.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/hobby/yarn-substitution \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"yardage":1200,"skein_length":220,"substitute_skein_length":180}'const res = await fetch("https://api.kit.forhosting.com/hobby/yarn-substitution", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"yardage": 1200,
"skein_length": 220,
"substitute_skein_length": 180
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/hobby/yarn-substitution",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"yardage": 1200,
"skein_length": 220,
"substitute_skein_length": 180
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/yarn-substitution", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"yardage":1200,"skein_length":220,"substitute_skein_length":180}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"yardage":1200,"skein_length":220,"substitute_skein_length":180}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/yarn-substitution", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"yardage": 1200,
"skein_length": 220,
"substitute_skein_length": 180
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "hobby.yarn_substitution",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Informe yardage, skein_length e substitute_skein_length para obter substitute_skeins, original_skeins para comparação e uma razão de comprimentos em JSON determinístico para planejadores de projetos, aplicativos de artesanato e ferramentas de lojas.
Como a quantidade de novelos substitutos é calculada a partir da metragem e dos comprimentos
Envie os campos obrigatórios yardage, skein_length e substitute_skein_length como números JSON ou strings numéricas. Os apelidos yards, metres, meters, total_yardage e yarn_needed mapeiam para yardage; original_skein_length, pattern_skein, hank_length e ball_length mapeiam para skein_length; sub_skein_length, new_skein_length, substitute_length e sub_length mapeiam para substitute_skein_length. Limites de magnitude mantêm os resultados finitos no isolate do Worker.
Lendo os campos da resposta e comparando original versus substituto
O campo formula pode ser exibido ao lado dos números com segurança, para que a pessoa veja que novelos substitutos é o teto da metragem sobre o comprimento do substituto. Prefira os comprimentos honestos do rótulo em vez de promessas arredondadas de marketing, e lembre-se de que novelos da mesma espessura ainda podem diferir em metragem quando a densidade da fibra muda. Em caso de sucesso, a resposta ecoa yardage, skein_length e substitute_skein_length após arredondamento estável, além de original_skeins igual ao teto da metragem sobre o comprimento do novelo original, substitute_skeins igual ao teto da metragem sobre o comprimento do novelo substituto, length_ratio igual ao comprimento original dividido pelo comprimento substituto, uma string de fórmula legível e method igual a ceil_yardage_over_substitute_length. Use substitute_skeins quando sua lista de compras precisa de uma única quantidade a comprar; use original_skeins quando quiser ver como ficaria a contagem de novelos da própria receita com a meada informada; use length_ratio quando estiver comparando duas apresentações de relance. Este endpoint não converte unidades, não confere amostras de tensão, não combina lotes de tingimento nem recomenda composição de fibra; é aritmética transparente de comprimento, não uma suíte completa de consultoria de fios. Campos obrigatórios ausentes, valores não finitos e comprimentos de novelo zero ou negativos falham com invalid_input e não são cobrados depois que o motor rejeita a requisição, de modo que envios de formulário ruins nunca drenam saldo pré-pago numa falha de validação.
Uso da API, preços, fluxos de artesanato e limites práticos
Chame a calculadora gratuita de substituição de fios no navegador para planejar o estoque, demonstrações em aula e conferências rápidas no balcão da loja sem instalar uma planilha. Para projetos multicoloridos, chame uma vez por cor, para que cada total continue auditável em logs e tickets de suporte. Envie um corpo JSON com yardage, skein_length e substitute_skein_length (ou os apelidos documentados). Use a API pré-paga quando um marketplace de artesanato, aplicativo de inventário, editora de receitas, quiosque de loja de fios ou planejador de projetos precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo. Combine este endpoint com um conversor de unidades separado quando os rótulos misturarem jardas e metros — converta primeiro e depois chame aqui com um único sistema de unidades. Autores que publicam SDKs podem mapear substitute_skeins para widgets de carrinho que mostram “compre sete novelos” e original_skeins para uma linha de comparação — o mesmo esquema que quem tricota rascunha num papel ao dividir a metragem pelo comprimento da meada à mão antes de uma grande compra de fio para um suéter.
Perguntas técnicas
Como calculo quantos novelos substitutos comprar?
Envie JSON com yardage (metragem total da receita), skein_length (comprimento da meada original) e substitute_skein_length (comprimento do novelo novo). O campo substitute_skeins da resposta é ceil(yardage / substitute_skein_length).
O que acontece se o comprimento do novelo for zero?
A requisição falha com invalid_input. skein_length (ou substitute_skein_length) zero ou negativo é rejeitado, para que a calculadora nunca divida por zero; falhas de validação não são cobradas.
Por que o resultado é um teto em vez de uma divisão simples?
Fio é vendido em novelos inteiros. Um resultado fracionário como 6.67 significa que você ainda precisa de um sétimo novelo para cobrir a metragem restante, então substitute_skeins sempre arredonda para cima.