食谱成分解析器 API

API ID 14910

将食谱配料行解析为数量、单位、项目、准备和过道,并标记过敏原关键词和单位转换

API 文档

端点

请求
发送“line”(一行)或“lines”(1-100行,每行最多300个字符)。一个批次算作一个请求。标题如“调料:”返回为类型“heading”,空行返回为“empty”。每个结果都有相同的字段;缺失部分为null。过敏原标志:过敏原标志是对行文本(美国九大主要食品过敏原)的关键词匹配,而不是安全检查:它们无法查看产品的完整成分、“可能含有”警告或交叉接触。请检查标签
Endpoint ID: 38816
GET https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38816/parse+one+ingredient+line
输入参数

解析一个成分行 — 端点功能

对象 描述
line 必需 One ingredient line, URL-encoded.

剩余免费测试请求:3 / 3。


输入参数

line
API 示例响应
JSON
{
    "input": "2 (14.5 oz) cans diced tomatoes, drained",
    "kind": "ingredient",
    "amount": 2,
    "amountMax": null,
    "approximate": false,
    "unit": "can",
    "unitText": "cans",
    "size": {
        "amount": 14.5,
        "unit": "oz"
    },
    "item": "diced tomatoes",
    "prep": "drained",
    "notes": null,
    "optional": false,
    "key": "diced tomato",
    "label": "diced tomatoes (canned)",
    "known": true,
    "alternatives": [],
    "includes": [],
    "aisle": "pantry",
    "confidence": 1,
    "unparsed": null,
    "allergenFlags": []
}
解析一个成分行 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38816/parse+one+ingredient+line?line=2 (14.5 oz) cans diced tomatoes, drained' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
发送“行”或“数量”+“单位”(+“项目”用于体积<->重量),以及“到”和选项 发送“行”(1-100),一“行”或单个数量(“数量”“单位”和对于体积<->重量,“项目”)。“到”是“公制”“美国”或一个单位(克毫升杯盎司…) 体积仍然是体积,重量仍然是重量,除非偏好是“重量”或“体积”,或“到”是另一种单位;这使用我们表格中的项目密度,每个这样的答案都有密度基础和近似:真(如何填充一杯会使一杯面粉的量变化10-20%)没有密度的项目、计数单位(丁香、罐头)和没有数量的行都会返回转换:假和一个原因(无密度、不可转换、无单位、无数量、无项目),绝不会进行猜测 茶匙和汤匙保持为公制的勺子,除非勺子是“转换” 一根黄油是113.4克
Endpoint ID: 38817
GET https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38817/us+-+metric+for+one+line+or+one+quantity
输入参数

美国 - 一行或一种数量的公制 — 端点功能

对象 描述
line 可选 One ingredient line (instead of amount + unit).
amount 可选 A single quantity: a number or text like "1 1/2".
unit 可选 The unit of amount (g, cup, tbsp, oz...).
item 可选 What it is, for volume <-> weight (e.g. sugar, flour, butter).
to 必需 "metric", "us" or a volume/weight unit.
prefer 可选 same, weight or volume.
spoons 可选 keep (teaspoons and tablespoons stay spoons in metric) or convert.
rounding 可选 kitchen (measuring steps) or none.

剩余免费测试请求:3 / 3。


输入参数

line
amount
unit
item
to
prefer
spoons
rounding
API 示例响应
JSON
{
    "to": "cup",
    "item": "sugar",
    "key": "sugar",
    "from": {
        "amount": 250,
        "amountMax": null,
        "unit": "g"
    },
    "kind": "ingredient",
    "converted": true,
    "amount": 1.25,
    "amountMax": null,
    "unit": "cup",
    "exactAmount": 1.25,
    "exactAmountMax": null,
    "density": {
        "gramsPerCup": 200,
        "basis": "granulated",
        "approximate": true
    },
    "text": "1 ¼ cups sugar"
}
美国 - 一行或一种数量的公制 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38817/us+-+metric+for+one+line+or+one+quantity?amount=250&unit=g&item=sugar&to=cup&prefer=same&spoons=keep&rounding=kitchen' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
对于存储成分作为数据的应用程序 复数形式遵循读者看到的内容(“½ 杯”、“1 杯”、“1½ 杯”、“2-3 杯”;计数物品也遵循:“1 个鸡蛋”、“3 个鸡蛋”、“2 个大洋葱”);测量物品保持您的措辞 分数:unicode(1½,默认),ascii(1 1/2)或十进制;公制数量始终为十进制 单位:短(tbsp,默认)或长(汤匙;拼写=uk 给升) 系统:保持(默认)、美国或公制,按与 /convert 相同的规则转换(勺子仍然是勺子,体积永远不变为重量) prepPosition 自动将切割词(切碎、剁碎、切丁……)放在测量项目前(“1 杯切碎的洋葱”)并在逗号后放置其他所有内容(“1 杯面粉,过筛”保持其含义;“2 瓣大蒜,剁碎”) 注释在逗号后跟随;可选添加“(可选)” 每一行写入的内容通过 /parse 读取回相同字段
Endpoint ID: 38818
GET https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38818/structured+fields+in+a+natural+ingredient+line+out
输入参数

自然成分线中的结构化字段 — 端点功能

对象 描述
amount 可选 The amount: 1.5, "1 1/2", "1½" (leave out for "salt, to taste").
amountMax 可选 The top of a range (2-3: amount=2, amountMax=3).
unit 可选 The unit in any spelling /parse knows: cup, cups, tbsp, tablespoon, g, clove, can, large... (leave out for counted items).
item 必需 The ingredient.
prep 可选 Preparation: "finely chopped", "sifted", "drained and rinsed".
notes 可选 Anything else, after a comma: "plus more to serve".
optional 可选 Add "(optional)". Default false.
system 可选 keep (default), us or metric.
fractions 可选 unicode (default), ascii or decimal.
units 可选 short (default) or long unit names.
prepPosition 可选 auto (default), before or after the item.
spelling 可选 us (default: liters) or uk (litres) for long metric names.

剩余免费测试请求:3 / 3。


输入参数

amount
amountMax
unit
item
prep
notes
optional
system
fractions
units
prepPosition
spelling
API 示例响应
JSON
{
    "text": "1½ cups finely chopped onions",
    "parts": {
        "quantity": "1½",
        "unit": "cups",
        "item": "onions",
        "prep": "finely chopped",
        "prepPosition": "before",
        "notes": null,
        "optional": false
    },
    "amount": 1.5,
    "amountMax": null,
    "unit": "cup",
    "key": "onion",
    "aisle": "produce",
    "options": {
        "system": "keep",
        "fractions": "unicode",
        "units": "short",
        "prepPosition": "auto",
        "spelling": "us"
    },
    "note": "prepPosition \"auto\" puts cutting words (chopped, minced, diced, sliced...) before a measured item (\"1 cup chopped onions\") and everything else after a comma (\"1 cup flour, sifted\" keeps its meaning; \"2 cloves garlic, minced\"); set prepPosition to choose."
}
自然成分线中的结构化字段 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14910/recipe+ingredient+parser+api/38818/structured+fields+in+a+natural+ingredient+line+out?amount=1 1/2&unit=cups&item=onions&prep=finely chopped&optional=false&system=keep&fractions=unicode&units=short&prepPosition=auto&spelling=us' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 食谱成分解析器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

将食谱成分行解析为数量、单位、项目、准备方法和过道,并带有过敏原关键字标记和单位转换

食谱成分解析器 API FAQs

不 它们是该行单词的关键词匹配(黄油 酱油 胡桃等)它们无法看到产品的完整成分 “可能含有” 警告或交叉接触 所以请始终检查标签

美国九大主要食物过敏原:牛奶 鸡蛋 鱼类 甲壳类海鲜 干果 花生 小麦 大豆 和 芝麻 椰子不被标记为干果

是的:“2杯小麦面粉”与“2 cups all-purpose flour”得到相同的键。较不常见的名称可靠性较低,因此请检查置信度

无法放置的文本返回未解析状态且置信度下降;没有任何被创造

体积到重量仅适用于已知密度的物品(面粉 糖 黄油 牛奶以及大约60种其他物品);其他的回答转换为:false,理由是no_density

每个端点返回与食谱成分相关的结构化数据,包括解析的细节,如数量、单位、项目、准备方法、过道和过敏原标记。对于转换,它提供转换后的数量和单位,并在适用时提供密度信息

关键字段包括“数量”“单位”“项目”“准备”“过道”“过敏原标志”和“信心”对于转换,还包括“转换”“确切数量”和“密度”等附加字段,提供有关成分的全面细节

参数包括“line”用于单个或多个成分字符串 “amount”和“unit”用于转换 “to”用于指定目标单位 用户还可以使用“system”“fractions”和“prepPosition”等选项自定义请求

响应数据以JSON格式组织,每个成分行解析为不同的字段 每个响应包含一个“kind”字段,指示类型(成分、标题、空)以及结构化部分,以便于访问特定细节

端点提供有关成分解析、单位转换和成分行的结构化输出的信息 它们涵盖了测量、准备方法和过敏原识别等各个方面,满足不同的烹饪需求

用户可以通过访问特定字段来利用返回的数据进行食谱开发、饮食跟踪或成分替代。例如,“prep”字段可以指导烹饪方法,而“allergenFlags”有助于饮食考虑

典型的用例包括食谱应用开发 餐饮规划 饮食分析和食材替代 该API可以帮助厨师和家庭厨师准确测量和转换各种食谱中的食材

数据准确性通过一致的解析算法和预定义的常见成分密度表来保持 API还提供置信度分数,使用户能够评估解析结果的可靠性

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API