एपीआई के बारे में
एपीरियॉडिक मोनोटाइल जनरेटर एपीआई स्पेक्ट्री टाइल 1,1 (आइंस्टीन मोनोटाइल) का उपयोग करके बिना गैप के एपीरियॉडिक मोनोटाइल ज्यामिति के लिए एक होस्टेड रेस्ट सेवा है यह एक क्षेत्र को बिना दोहराने वाले टाइलिंग से भरता है इसे एक मुखौटा आकार में क्लिप करता है स्थिर टाइल आईडी और लेबल असाइन करता है और उत्पादन-तैयार कलाकृतियों को एक्सपोर्ट करता है यह डेवलपर्स और एआई एजेंटों के लिए बनाया गया है जिन्हें क्लाइंट पर सब्स्टिट्यूशन डेप्थ एटलस निर्माण या फ्रैक्टल इटरेशन टूलिंग चलाए बिना असली टाइलिंग की आवश्यकता है यह कंप्यूटर ग्राफिक्स प्रक्रियात्मक दुनिया ब्लेंडर और गेम इंजनों एडोब और सीएडी 3डी प्रिंटिंग जनरेटिव आर्ट वैज्ञानिक दृश्यांकन मेटामटेरियल तरंग और ध्वनिक लेआउट क्रिप्टोग्राफी से जुड़े ग्रिड प्रयोगों और डेटा पाइपलाइनों का समर्थन करता है जिन्हें स्थिर ज्यामिति की आवश्यकता होती है
इस एपीआई को क्या प्राप्त होता है और आपका एपीआई क्या प्रदान करता है (इनपुट/आउटपुट)
आप एक मुखौटा और आउटपुट प्रारूपों के साथ JSON भेजते हैं मुखौटा में वृत्त आयत वर्ग त्रिकोण नियमित हेक्सागोन और गोलाकार आयत शामिल होते हैं जो स्वचालित रूप से कैनोनिकल टाइल यूनिट में केंद्रित होते हैं वैकल्पिक स्केल रोटेशन बीज SVG स्ट्रोक और पैलेट विकल्प रास्टर मात्राएँ और 3डी एक्सट्रूज़न गहराई होते हैं X-API-Key हेडर के साथ प्रमाणित करें कार्यप्रवाह व्यक्तिगत है एक पैच कार्य बनाएं कार्य स्थिति को पूर्ण या विफल होने तक जांचें फिर हस्ताक्षरित डाउनलोड यूआरएल प्राप्त करें प्रारूप में PNG JPG JPEG SVG CSV JSON STL GLB STL_ZIP OBJ_ZIP और INSTANCE_JSON शामिल हैं GLB प्रत्येक टाइल के लिए एक नामित नोड प्रदान करता है STL ZIP और OBJ ZIP प्रत्येक टाइल के लिए स्वतंत्र जाल प्रदान करते हैं मुफ्त कुंजियाँ केवल छोटे रास्टर पूर्वदृश्य की अनुमति देती हैं भुगतान किए गए सोलो और वाणिज्यिक कुंजियाँ वेक्टर 3डी ज़िप बंडल और बड़े कार्यों को अनलॉक करती हैं वैकल्पिक Idempotency-Key हेडर पुनः प्रयास पर डुप्लिकेट सबमिशन को रोकता है बड़े कार्यों से पहले लाइव स्तर सीमाओं समर्थित मुखौटों प्रारूपों और कतार की गहराई का निरीक्षण करने के लिए क्षमताओं एंडपॉइंट को कॉल करें
इस एपीआई के सबसे सामान्य उपयोग मामले क्या हैं
रेन्डरिंग और बनावट के लिए एंटी-मोइरे और गैर-कालानुक्रमिक सैंपलिंग यूनिटी गोडोट और थ्री.जेएस में GLB के माध्यम से प्रक्रियात्मक जाल और विश्व सजावट ब्लेंडर ऐड-ऑन और टाइल्ड सतहों के लिए पाइपलाइन एकीकरण इलेस्ट्रेटर इनस्केप और लेजर या प्लॉटर कार्य फ्लो के लिए वेक्टर आउटपुट SVG के माध्यम से STL या भिन्न प्रिंट करने योग्य टाइल के साथ एकल-पैनल 3डी प्रिंटिंग STL ZIP और OBJ ZIP के साथ जनरेटिव मूर्तिकला और सजावटी डिजाइन एपीरियडिक टाइलिंग पर शोध और शिक्षा अनुकूलित आयातकों स्थानिक इंडेक्सिंग और मशीन लर्निंग डेटा सेट के लिए CSV JSON और INSTANCE मैनिफेस्ट एजेंटों को उपयोगकर्ताओं को PNG या JPG पर शुरू करना चाहिए डिज़ाइन उपकरणों के लिए SVG रीयलटाइम 3डी के लिए GLB निर्माण पैनलों के लिए STL और जब प्रत्येक टाइल एक स्वतंत्र वस्तु होनी चाहिए तो STL_ZIP पर जाना चाहिए
क्या आपकी योजनाओं में कोई सीमाएँ हैं
मुफ्त स्तर छोटे PNG और JPG पूर्वदृश्य तक सीमित है भारी कार्य जैसे बड़े GLB या ज़िप एक्सपोर्ट को छोटे मानक या भारी के रूप में वर्गीकृत किया जाता है और कतार में हो सकते हैं प्रतिक्रियाएँ अनुमानित प्रतीक्षा और कतार स्थिति शामिल करती हैं इसलिए ग्राहकों को फिर से सबमिट करने के बजाय जांच करनी चाहिए हस्ताक्षरित डाउनलोड यूआरएल समाप्त हो जाते हैं उपयोगकर्ताओं को उन कलाकृतियों को सहेजने की आवश्यकता होती है जो उनके लिए महत्वपूर्ण हैं अंतिम उपयोगकर्ताओं से टाइल परिवार मुखौटा केंद्र में रोकने के तरीके पैच संस्करण सब्स्टिट्यूशन गहराई या कवरेज सीमा के लिए न पूछें एआई एजेंटों के लिए पूर्ण मशीन-पठनीय एकीकरण मार्गदर्शन इस सूची में कॉन्फ़िगर की गई प्रदाता दस्तावेज़ साइट पर उपलब्ध है
{"status":"ok","ts":1779302690.671844}
curl --location --request GET 'https://zylalabs.com/api/12628/aperiodic+monotile+generator+api/24439/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
{"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/12628/aperiodic+monotile+generator+api/24440/capabilities' --header 'Authorization: Bearer YOUR_API_KEY'
{"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/12628/aperiodic+monotile+generator+api/24441/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
}'
{"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/12628/aperiodic+monotile+generator+api/24442/get+job+download+urls&job_id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक एंडपॉइंट JSON डेटा लौटाता है स्वास्थ्य जांच एंडपॉइंट API की स्थिति की पुष्टि करता है जबकि क्षमताएँ एंडपॉइंट समर्थित प्रारूपों मास्क और स्तर सीमाओं पर विवरण प्रदान करता है क्रिएट पैच जॉब एंडपॉइंट नौकरी की स्थिति और आईडी लौटाता है और गेट जॉब डाउनलोड यूआरएल एंडपॉइंट जेनरेट की गई फ़ाइलों को डाउनलोड करने के लिए यूआरएल प्रदान करता है
मुख्य क्षेत्रों में `status` `job_id` `urls` `estimated_seconds` और `ttl_seconds` शामिल हैं उदाहरण के लिए Create Patch Job प्रतिक्रिया में `job_id` और `status` शामिल है जबकि Get Job Download URLs प्रतिक्रिया में उत्पन्न फ़ाइलों तक पहुँचने के लिए `urls` शामिल है
मानक में सीमा आकार (मास्क), रंग पैलेट, पैमाना, घूर्णन, और टाइल गुण जैसे पक्ष शैली और आयाम अनुपात शामिल हैं उपयोगकर्ता इन मानकों को JSON पेलोड में निर्दिष्ट करके अपनी अनुरोधों को अनुकूलित कर सकते हैं
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है जिसमें क्षेत्रों को श्रेणीबद्ध रूप से व्यवस्थित किया गया है उदाहरण के लिए जॉब डाउनलोड यूआरएल की प्रतिक्रिया में एक `job_id` `status` और एक नटेड `urls` ऑब्जेक्ट शामिल है जिसमें डाउनलोड करने योग्य फ़ाइल लिंक होते हैं
क्षमता अंत बिंदु समर्थित आउटपुट प्रारूपों, मास्क प्रकारों, स्तर सीमाओं और कतार सेटिंग्स के बारे में जानकारी प्रदान करता है यह उपयोगकर्ताओं को समझने में मदद करता है कि उनके पैच कार्यों के लिए कौन से प्रारूप और आकार अनुमेय हैं
उपयोगकर्ता लौटाए गए डेटा का उपयोग `status` फ़ील्ड की जांच करके नौकरी की प्रगति की निगरानी करने के लिए कर सकते हैं `job_id` का उपयोग करके विशिष्ट नौकरियों का संदर्भ देने के लिए और `urls` का उपयोग करके जनरेट की गई फ़ाइलें डाउनलोड करने के लिए जब नौकरी पूरी हो जाए
विशिष्ट उपयोग के मामले में ग्राफिक्स के लिए गैर-दोहराते बनावट उत्पन्न करना गेम विकास के लिए प्रक्रियात्मक मेष बनाना और 3डी प्रिंटिंग के लिए STL फ़ाइलें उत्पन्न करना शामिल है उपयोगकर्ता शिक्षा उद्देश्यों के लिए अयोज्य टाइलिंग का अध्ययन करने के लिए API का लाभ भी उठा सकते हैं
डेटा सटीकता को उन्नत एल्गोरिदम के उपयोग के माध्यम से बनाए रखा जाता है जो निश्चित टाइलिंग पैटर्न उत्पन्न करते हैं एपीआई स्थिर टाइल आईडी और लेबल असाइन करके स्थिर आउटपुट सुनिश्चित करता है जिससे विभिन्न अनुप्रयोगों में विश्वसनीय एकीकरण संभव होता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
965ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,653ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,407ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,132ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
5,092ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,261ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
54ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
9,854ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
620ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,323ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
5,998ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
342ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
956ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
86ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
7,635ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
96ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
60ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,471ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,507ms