Nutrition Facts Label Generator

Generate FDA-compliant Nutrition Facts labels as SVG or PNG from JSON data. Automatic rounding, %DV calculation, 5 layout variants, allergen bolding, 20+ vitamins/minerals.

原始信息汇总

Nutrition Facts Label Generator API 数据集概述

基本信息

• API名称: Nutrition Facts Label Generator
• 提供商: Noah McGehee
• 类别: Food
• 当前版本: 1.0.0
• 订阅计划:
  • BASIC: $0.00 / mo
  • PRO: $15.00 / mo
  • ULTRA: $49.00 / mo
  • MEGA: $129.00 / mo

核心功能

生成符合美国食品药品监督管理局（FDA）标准的营养成分标签，支持SVG或PNG格式输出。功能包括自动数值舍入、每日摄入量百分比（%DV）计算、5种布局变体、过敏原加粗显示，以及支持20多种维生素和矿物质。

主要特性

• FDA合规性: 营养数值舍入、%每日摄入量计算和排版均严格遵循21 CFR 101.9法规。
• 输出格式: SVG（无限缩放，文件体积小）和PNG（便于直接用于文档、电子邮件和网页）。
• 布局变体:
  • standard: 标准垂直布局
  • tabular: 表格布局
  • linear: 线性布局
  • dual-column: 双列布局
  • supplement: 补充剂事实面板
• 支持营养素: 超过20种FDA认可的可选维生素和矿物质，使用2020年参考量自动计算%每日摄入量。
• 成分与过敏原: 支持完整成分列表和过敏原名称，过敏原将根据FDA要求自动加粗。
• 性能: 典型响应时间低于50毫秒。

请求与响应

• 主要端点: POST /label
• 请求格式: JSON
• 响应格式: SVG (Content-Type: image/svg+xml) 或 PNG (Content-Type: image/png)，均包含建议文件名的Content-Disposition头。

请求体字段

字段	类型	必需	描述
nutrition	object	是*	营养成分数据（见下方营养素表）
supplementData	object	是*	补充剂事实数据（仅用于supplement变体）
format	string	否	"svg"（默认）或"png"
variant	string	否	标签布局："standard"、"tabular"、"linear"、"dual-column"、"supplement"
width	integer	否	标签宽度（像素，见下方宽度范围）
dpi	integer	否	PNG分辨率：72–600（默认300，SVG忽略）

*说明：除supplement变体外，所有变体使用nutrition。supplement变体使用supplementData。

必需营养素字段

字段	单位	示例
servingSize	string	"2/3 cup (55g)"
servingsPerContainer	number or string	8 or "about 8"
calories	number (kcal)	230
totalFat	{"amount": g}	{"amount": 8}
saturatedFat	{"amount": g}	{"amount": 1}
transFat	{"amount": g}	{"amount": 0}
cholesterol	{"amount": mg}	{"amount": 0}
sodium	{"amount": mg}	{"amount": 160}
totalCarbs	{"amount": g}	{"amount": 37}
dietaryFiber	{"amount": g}	{"amount": 4}
totalSugars	{"amount": g}	{"amount": 12}
addedSugars	{"amount": g}	{"amount": 10}
protein	{"amount": g}	{"amount": 3}

可选字段

• 可选维生素与矿物质: vitaminD, calcium, iron, potassium, vitaminA, vitaminC, vitaminE, vitaminK, thiamin, riboflavin, niacin, vitaminB6, folate, vitaminB12, biotin, pantothenicAcid, phosphorus, iodine, magnesium, zinc, selenium, copper, manganese, chromium, molybdenum, chloride。
• 其他可选字段:
  • productName: 字符串，显示在标签顶部（最多200字符）。
  • ingredients: 字符串，完整成分列表文本（最多2000字符）。
  • allergens: 数组，成分中需要加粗的过敏原名称，例如["milk", "soy", "wheat"]。

布局变体宽度范围

变体	最小宽度（像素）	最大宽度（像素）	默认宽度（像素）
standard	250	500	280
tabular	450	800	600
linear	350	900	500
dual-column	300	600	340
supplement	250	500	280

错误响应

所有错误均返回JSON格式。

状态码	含义
400	输入无效 — 检查details数组中的具体字段错误
401	API密钥缺失或无效
413	请求体过大（限制1 MB）
429	超出速率限制
500	渲染过程中服务器错误

应用场景

• 食品包装：为产品包装生成可直接打印的标签。
• 营养应用程序：根据用户输入或数据库值动态显示标签。
• 食谱计算器：显示自定义食谱的营养成分。
• 电子商务：在产品列表页显示合规标签。
• 法规合规：为FDA提交生成标签。
• 菜单标签：为餐厅和餐饮服务项目制作标签。