创新的非周期单砖生成器 API

API ID 12633

探索创新的单瓷砖解决方案,利用我们的创新非周期单瓷砖生成器API推动设计边界

API 文档

端点

请求
返回带有状态为ok和时间戳的JSON,当API进程处于活动状态时使用此项来验证Zyla是否能够在测试补丁或作业端点之前访问后端
Endpoint ID: 24459
GET https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24459/health+check
输入参数

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

此端点不需要任何输入参数。

API 示例响应
JSON
{"status":"ok","ts":1779302690.671844}
健康检查 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24459/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回实时支持的输出格式、掩码类型、层级限制、队列设置和您的 API 密钥的汇总 在进行大型补丁作业之前调用此方法,以便代理知道哪些格式和大小是允许的
Endpoint ID: 24460
GET https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24460/capabilities
输入参数

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

此端点不需要任何输入参数。

API 示例响应
JSON
{"patch_engine_semver":"1.0.0","supported_tile_families":["spectre_tile_1_1"],"roadmap":{"tile_families":[{"id":"spectre_tile_1_1","status":"supported","label":"Spectre / Tile(1,1)"},{"id":"einstein_hat_tile","status":"planned","label":"Einstein Hat monotile (same API hooks)"},{"id":"turtle_tile","status":"planned","label":"Companion turtle monotile family"}]},"free_tier_formats":["jpeg","jpg","png"],"supported_masks":["square","rectangle","circle","regular_hexagon","triangle","rounded_rect"],"supported_formats":["svg","csv","json","stl","stl_zip","obj_zip","glb","instance_json","png","jpg","jpeg"],"output_notes":{"glb":"3D tiled scene with one named, movable node per retained tile.","stl":"Whole-panel mesh output.","stl_zip":"Independent STL files, one per tile.","obj_zip":"Independent OBJ files, one per tile."},"boundary_behavior":"clip","visual_styling":{"side_styles":["flat","curvy","wavy","jagged","blocky"],"side_style_aliases":{"curved":"curvy","curve":"curvy"},"side_style_amplitude":{"min":0.0,"max":0.75,"default":0.12},"tile_edge_ratio":{"min":0.25,"max":4.0,"default":1.0,"note":"Anisotropic stretch of export geometry only; substitution placement remains canonical Tile(1,1). Not a true Tile(a,b) two-family substitution."},"side_style_wavy_segments":{"min":4,"max":64,"default":10},"palette_by_label":{"supported":true,"keys_per_label":["fill","stroke","opacity","stroke_width"],"wildcard_label":"*"},"request_fields":["side_style","side_style_amplitude","tile_edge_ratio","side_style_wavy_segments","palette_by_label"]},"limits":{"max_supertile_iterations":26,"max_tiles_per_job":500000,"sync_max_tiles":8000,"svg_max_tiles_hard":25000,"png_max_dimension_px":16000,"png_max_pixels":50000000,"max_output_bytes_soft":32212254719,"max_wall_time_sec":3600.0,"job_gc_hours":24,"stl_tile_instancing_floor":50000,"svg_max_chars":400000000,"redis_url":null},"atlas":{"available":true,"max_canonical_half_side":1544.0511060838514,"max_canonical_full_side":3088.102212167703,"cores":[{"tile_family":"spectre_tile_1_1","iterations":5,"tile_count":34649,"inscribed_half_side":72.85611373427516,"inscribed_center":[180.85884907869263,-190.4637563106116],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":6,"tile_count":272791,"inscribed_half_side":197.20129785929603,"inscribed_center":[611.0929636810714,-457.26130132202326],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":7,"tile_count":2147679,"inscribed_half_side":516.3669015101796,"inscribed_center":[1297.8529395021253,-1742.7605795910576],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":8,"tile_count":16908641,"inscribed_half_side":1544.0511060838514,"inscribed_center":[4553.311273135866,-4060.276908476975],"patch_version":"1.0.0"}]},"coordinate_convention":"Canonical Tile(1,1) planar coordinates (unit-edge reference). Global client scale ∈ ℝ⁺ and rotation_deg are similarity transforms applied after substitution.","operational":{"run_jobs_in_process":false,"rate_limit_post_patch":"30/minute","queue_max_active_jobs":2000,"queue_max_active_jobs_per_key":100,"queue_max_heavy_jobs":300,"queue_max_heavy_jobs_per_key":10,"download_ttl_seconds_max":3600,"artifact_retention_note":"Generated artifacts are kept for roughly one hour after the job completes. Download or copy them to your own storage if you need them longer."}}
能力 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24460/capabilities' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求

从 JSON 中创建一个具有可调边界形状、调色板、比例、边样式、边 a/b 比率的非周期单瓦片补丁,支持 SVG、GLB、STL 或 PNG 格式

 

mask: 瓷砖区域,单位为标准的 Tile(1,1),以原点为中心。必须包括类型。支持的类型:正方形(半边长)、圆形(半径)、矩形(宽度、高度)、三角形(边长)、规则六边形(外接圆半径)、圆角矩形(宽度、高度、圆角半径)。示例:{"type":"circle","radius":50}。

formats: 要生成的输出文件格式。允许的值:svg、png、jpg、jpeg、csv、json、stl、stl_zip、obj_zip、glb、instance_json。至少需要一种格式;省略该字段则使用默认列表。

scale: 放置后应用的全局相似度比例(必须大于 0)。用于按世界单位调整整个补丁的大小。

side_style: 导出几何体的边缘外观:平坦、曲线、波浪、锯齿状或块状。别名 curved 被接受并映射到 curvy。影响 SVG、PNG/JPG、STL/OBJ ZIP 和 GLB。

side_style_amplitude: 样式边缘的鼓起强度(0.0–0.75)。当 side_style 是平坦时被忽略。较高的值会产生更强的波浪或角落。

tile_edge_ratio: 只用于导出的瓷砖轮廓的各向异性拉伸(0.25–4.0)。除了 1.0 以外的值会拉伸或压缩绘制的网格;放置保持标准 Tile(1,1),而不是实际的 Tile(a,b) 替代。

palette_by_label: 每个瓷砖标签的颜色,用于 SVG 和栅格。键是瓷砖标签(例如 Gamma、Delta)或 "*" 表示默认。每个值可以包括填充、轮廓、不透明度和透明(布尔值)。示例:{"Gamma":{"fill":"#d94738"},"*":{"opacity":0.95}}。

stl_extrusion_mm: 用于 stl、stl_zip、obj_zip 和 glb 输出的挤出厚度(以毫米为单位,必须大于 0)。如果未请求这些格式,则无效果。

svg_fill: 默认 SVG 填充颜色(例如 #cdd6ea)。

png_width_px: 当 png 在格式中时的栅格大小;两个值必须一起设置。

png_height_px: 当 png 在格式中时的栅格大小;两个值必须一起设置。

Endpoint ID: 24461
POST https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24461/create+patch+job
输入参数

创建补丁作业 — 端点功能

对象 描述
请求体 必需 Json

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


输入参数

API 示例响应
JSON
{"job_id":"bfb87a47-6910-462c-86ec-2bb63ca9bba7","status":"queued","tier":"tier_free","size_class":"small","estimated_seconds":5.0,"request_id":"2c7470cc-b96f-4725-b419-41826e2871e5","queue":{"status":"queued","size_class":"small","position":1,"estimated_wait_seconds":0.0}}
创建补丁作业 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24461/create+patch+job' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "mask": {"type": "circle", "radius": 16},
  "formats": ["png", "jpg"],
  "png_width_px": 512,
  "png_height_px": 512,
  "jpg_width_px": 512,
  "jpg_height_px": 512
}'

    
请求

“获取作业下载 URL”端点旨在检索与作业相关的可下载 URL 列表

job_id 参数:由创建补丁作业返回的作业 UUID

Endpoint ID: 24462
GET https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24462/get+job+download+urls
输入参数

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

API 示例响应
JSON
{"job_id":"bfb87a47-6910-462c-86ec-2bb63ca9bba7","status":"completed","ttl_seconds":900,"urls":{"patch.jpg":"/v1/downloads/bfb87a47-6910-462c-86ec-2bb63ca9bba7/patch.jpg?exp=1779375751&sig=d61d646a3e3893ba4bd7c753a46cb9af2e8eca4178467ec19f62a2481ad3d39a","patch.png":"/v1/downloads/bfb87a47-6910-462c-86ec-2bb63ca9bba7/patch.png?exp=1779375751&sig=c6c4732a4874653588673c05fe14fb4570047b05603da7318d701d7694ec5064"}}
获取工作下载网址 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/12633/innovative+aperiodic+monotile+generator+api/24462/get+job+download+urls&job_id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

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

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

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


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

概览

关于API 非周期单元生成器API是一个托管的REST服务,用于使用Spectre Tile 1,1(爱因斯坦单元)生成无间隙的非周期单元几何图形。它用非重复的镶嵌填充区域,截取成遮罩形状,分配稳定的瓷砖ID和标签,并导出生产就绪的工件。为需要真实镶嵌而无需在客户端运行替换深度、图集构建或分形迭代工具的开发人员和AI代理而构建。支持计算机图形学、程序化世界、Blender和游戏引擎、Adobe和CAD、3D打印、生成艺术、科学可视化、超材料、波动和声学布局、与密码学相关的晶格实验,以及需要确定性几何体的数据管道。 该API接收什么以及您的API提供什么(输入/输出) 您发送包含遮罩和输出格式的JSON。遮罩包括圆形、矩形、正方形、三角形、正六边形和圆角矩形,自动在标准瓷砖单位中居中。可选的比例、旋转、种子、SVG笔画和调色板选项、栅格尺寸和3D挤出深度。通过头部X-API-Key进行身份验证。工作流程是异步的:创建补丁作业,轮询作业状态直到完成或失败,然后获取签名的下载URL。格式包括png、jpg、jpeg、svg、csv、json、stl、glb、stl_zip、obj_zip和instance_json。GLB为每个瓷砖提供一个命名节点。STL ZIP和OBJ ZIP为每个瓷砖提供独立的网格。免费密钥仅允许小型栅格预览。付费的Solo和Commercial密钥解锁矢量、3D、压缩包和更大的作业。可选的Idempotency-Key头防止在重试时重复提交。在进行大作业之前,请调用功能端点检查实时层级限制、支持的遮罩、格式和队列深度。 该API的最常见用例是什么 反莫尔和非周期采样用于渲染和纹理。通过GLB在Unity、Godot和Three.js中进行程序化网格和世界装饰。Blender插件和管道集成用于平铺表面。通过SVG为Illustrator、Inkscape和激光或绘图仪工作流程提供矢量输出。使用STL进行单面3D打印,或者使用STL ZIP和OBJ ZIP进行单独可打印的瓷砖。生成雕塑和装饰设计。关于非周期镶嵌的研究和教育。为自定义导入器、空间索引和机器学习数据集提供CSV、JSON和实例清单。代理应首先让用户使用png或jpg,然后转向设计工具的svg,用于实时3D的glb,用于制造面板的stl,以及在每个瓷砖必须是单独对象时使用stl_zip。 您的计划是否有任何限制 免费层限于小型PNG和JPG预览。大型GLB或压缩包导出等重型作业被分类为小型、标准或重型,可能会排队;响应包括预计等待和队列位置,因此客户端应轮询而不是重新提交。签名的下载URL会过期;用户必须保存他们关心的工件。不要询问最终用户瓷砖家族、遮罩中心、保留模式、补丁版本、替换深度或覆盖范围。有关AI代理的完整机器可读集成指导可在此列表中配置的提供者文档网站上找到

创新的非周期单砖生成器 API FAQs

每个端点返回 JSON 数据 健康检查端点确认 API 状态 而能力端点提供有关支持的格式 掩码和限制的详细信息 创建补丁作业端点返回作业状态和 ID 获取作业下载 URL 端点提供用于下载生成的工件的 URL

关键字段包括 `status`、`job_id`、`urls` 和 `estimated_seconds` 例如,创建补丁作业的响应包括用于跟踪的 `job_id`、表示作业状态的 `status` 和预计处理时间的 `estimated_seconds`

用户可以通过参数如`mask`、`scale`、`rotation`、`seed`和`palette`自定义请求。例如,指定一个`mask`类型如“圆形”或“矩形”决定了铺排的形状

响应数据结构为键值对 例如 创建补丁任务的响应包括 `job_id` `status` 和 `queue` 详细信息 使用户能够有效跟踪任务进度并检索结果

能力端点提供有关支持的输出格式、面具类型、层级限制和队列设置的信息 这帮助用户了解他们的补丁工作可接受的格式和大小

用户可以通过检查 `status` 字段来监控作业进度,并使用从获取作业下载 URL 响应中获得的 `urls` 来访问生成的工件。这使得与工作流程的无缝集成成为可能

典型的使用案例包括为图形生成非重复纹理 为游戏环境创建程序化网格 以及生成用于3D打印的STL文件 该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]

您可能还喜欢