Frequently Asked Questions

Text-to-CAD

General Overview

Q: What is Text-to-CAD and how does it work?

Text-to-CAD is our proprietary ML tool for converting a natural language prompt into KCL code. Zoo Design studio interprets KCL code to create a fully dimensioned B-Rep CAD model.

Q: What is Zookeeper, and how does it use Text-to-CAD?

Zookeeper is the built-in AI CAD assistant in Zoo Design Studio that helps you design, edit, and understand 3D models using the KittyCAD Language (KCL). When you request a change to your CAD model, Text-to-CAD is one of the tools Zookeeper uses to convert it into parametric KCL code and update the active project. This produces editable, parameterized designs you can iterate on quickly.

Q: Who can benefit from using Zookeeper?

Anyone from beginners and non-engineers to expert CAD users and enterprise teams can benefit from Zookeeper. It speeds up design by turning plain text requests into editable parametric KCL models for newcomers, while saving experts time with rapid prototyping, project-aware edits, and repeatable workflows that scale for teams.

Capabilities & Features

Q: Where is Zookeeper in Zoo Design Studio?

Zookeeper is a pane on the right side. Click the sparkles icon in the right control bar to open it. It's context-aware and works with your active project to create or edit designs.

Q: What types of CAD models can Zookeeper generate?

Zookeeper can generate a wide range of CAD models, from simple primitives and brackets to mechanical parts, enclosures, mounts, assemblies, and 3D-printable components, all from prompts. It can also edit existing models, interpret selected geometry and renders, and update the active project by producing or modifying parametric KCL code.

Q: Is Zookeeper Text-to-CAD?

Yes - Text-to-CAD is one of the core tools Zookeeper uses to turn your natural-language requests into parametric KCL models, but Zookeeper also provides context-aware edits, guidance, and CAD expertise beyond just generation.

Q: Can Zookeeper model things directly from text prompts?

Yes - Describe what you want and Zookeeper will try to generate the geometry as parametric KCL. If generation fails or needs tweaking, it will suggest prompt refinements or follow-up edits.

Q: Can Zookeeper suggest my next steps during modeling?

Yes - Zookeeper analyzes your active project and offers context-aware suggestions (e.g., add fillets, mounting holes, or adjust dimensions) to help you decide the next modeling steps. It can also propose small edits or refinements you can apply immediately.

Q: Can Zookeeper interpret selections I make in the project?

Yes - Zookeeper understands and uses your selections in the active project. When you select faces, edges, bodies, or code regions, Zookeeper uses that context to make targeted edits, add features, or generate more precise prompts.

Q: Can Zookeeper view and interpret renders of my model?

Yes - Zookeeper can view and interpret the project's renders and multiview snapshots to understand geometry and suggest or make context-aware edits. It uses those visual cues alongside selections and KCL to produce more accurate modifications.

Q: Can you ask Zookeeper questions?

Yes - You can ask Zookeeper questions about modeling, KCL, design decisions, or your active project. It will answer with guidance, explain steps, and can perform edits or generate models when you request them.

Q: How does a user get the most value from Zookeeper?

Be specific about what you want (dimensions, constraints, intended use) and include selections or reference geometry in the active project - clear prompts produce more accurate KCL results. Iterate: review the generated model, tweak parameters or ask for targeted edits, and accept Zookeeper's suggestions (fillets, holes, thickness changes) to quickly refine the design.

Q: What languages does Zookeeper understand?

Zookeeper understands natural-language prompts (primarily English) and can read and work with KCL code and selected geometry in your project. It also accepts many major languages (Spanish, French, German, Chinese, etc.) with varying accuracy, though the best results are typically in English.

Code (KCL) & CAD Knowledge

Q: What is KCL and how does it relate to Zookeeper?

KCL (KittyCAD Language) is Zoo Design Studio's domain-specific, parametric CAD programming language. KCL projects are collections of .kcl files (entrypoint: main.kcl) that programmatically create 3D geometry using primitives, sketches, transforms, booleans, and parameters.

Zookeeper is our built-in CAD design assistant inside Zoo Design Studio that helps you work with KCL: it can generate new KCL models from plain-language prompts, edit your existing .kcl code, answer questions about KCL, and propose design changes, acting as an intelligent, context-aware partner while you design.

Q: Can Zookeeper answer questions about KCL syntax and structure?

Yes - Zookeeper can read your KCL code, explain syntax and structure, and help fix or improve scripts. It can also suggest idiomatic KCL patterns and make project-aware edits when you ask.

Q: Can Zookeeper read and understand my KCL code?

Yes - Zookeeper can read and understand your KCL code, explain what it does, and use that context to suggest fixes or make targeted edits to the active project.

Q: Does Zookeeper reference official KCL materials?

Yes - Zookeeper references official KCL materials (including the KCL Book) to ensure advice and code follow best practices. See the KCL Book for details.

Q: Can Zookeeper fix KCL bugs?

Yes - Zookeeper can identify and fix KCL errors by analyzing your project and selected code, then applying targeted edits. If an automatic fix can't be applied, it will explain the issue and suggest a clear repair or simplified prompt for you to approve.

Q: Can Zookeeper help with mechanical engineering and design concepts?

Yes - Zookeeper can explain mechanical design concepts, recommend best practices (tolerances, fastening, draft, fillets), and help apply them to your model. It can provide guidance and simple calculations, but it doesn't replace engineering validation or guarantee manufacturability or structural performance.

Limitations

Q: What are Zookeeper's limits?
  • Can: create/edit KCL CAD models, explain KCL/design concepts, and make changes via the studio's AI actions.

  • Cannot: run physical tests, guarantee manufacturability or structural safety, or perform detailed engineering simulations.

  • Interaction rules: modifies projects only through the studio's built-in code actions and cannot paste raw KCL or show rendered images in chat.

  • Knowledge bounds: limited to its training and available docs; ask for clarification when requests are vague.

Q: What can't Zookeeper do yet?
  • Change ZDS application settings.

  • Control the viewport (you must rotate, pan, zoom manually).

  • Open or switch to other projects.

  • Export models or files.

  • Ingest arbitrary images or external 3D files as input.

  • Display backend-generated progress images.

  • Read files outside the active project directory.

  • Access your Zoo account or personal account information.

Troubleshooting

Q: How long will Zookeeper work on my problem before giving up?

Zookeeper makes an initial attempt and, if it encounters errors, will examine the error messages and try up to five automated fixes. If those attempts still fail, it stops, reports the problem, and offers simpler prompts or clarification options for you to choose.

Q: What happens when a Zookeeper prompt fails?

If a Zookeeper prompt fails, it stops and shows the error(s), explains what went wrong, and offers next steps - like a simpler prompt, clarification questions, or manual edits. It may try up to five automated fixes for edit actions; if those still fail it won't retry automatically and will wait for your instruction to proceed.

Q: Can Zookeeper make mistakes?

Yes. Zookeeper can make mistakes - it may misunderstand intent, produce incorrect geometry, or suggest designs that aren't manufacturable or safe. Always review and validate changes, run your own checks, and give clear, specific instructions or corrections when needed.

Q: Does Zookeeper support custom instructions or agent rules?

Short answer: Not persistently. You can give explicit instructions, constraints, or coding style rules in each prompt (and selections/params in the project guide edits), and Zookeeper will follow them for that action. It doesn't support global, always-on custom agent rules or persistent personality settings across sessions.

Q: What should I do if Zookeeper struggles to create a full model from a single prompt?

Break the task into smaller steps. Ask Zookeeper for a design plan first, then request geometry changes one feature at a time. Example flow:

  1. "Create the rectangular base."

  2. "Add corner holes."

  3. "Fillet the edges."

Working incrementally (and giving clear dimensions or constraints) gets better results than one large, vague prompt.

Q: How do I help Zookeeper focus on the right part of my model?

Select the exact geometry and give a concise instruction.

  • In the UI, highlight the face/edge/body or select the relevant lines in the code before asking.

  • Use clear, specific commands (e.g., "change this hole diameter to 5 mm" or "fillet these two edges with 2 mm").

  • Reference named parts or parameters if available (e.g., "modify mount_plate.thickness").

  • Provide constraints or intent when helpful (fit a M4 screw, keep wall ≥2 mm).

Doing this ensures Zookeeper applies changes to the correct part rather than guessing.

Q: Where should I report bugs or request features?

You can report bugs many ways.

  1. Submit a Github issue

  2. Report bugs on our Discord server

  3. Ask our team via our Community Forum

API

Q: Can I use the Zookeeper API?

Short answer: Only in limited ways for now. Zookeeper's API features are narrow but expanding. Currently you can use the Text-to-CAD endpoint to generate KCL models from prompts; more API-powered capabilities will be added over time.

Pricing

Q: How much does Zookeeper cost?

Free plans include 1,205 Zookeeper credits per month (a $10 balance), Plus plans come with 6,024 credits (a $50 balance), and Pro gives you unlimited access. Each second of processing uses 1 credit (worth $0.0083).

Platform Overview

Getting Started With Zoo Design Studio

Q: What is Zoo Design Studio?

Zoo Design Studio is a CAD application for hardware designers that provides the traditional point-and-click workflows found in common CAD applications, alongside Text-to-CAD ML and code based workflows.

Q: Is Zoo Design Studio available in a web browser or an installed application?

Zoo Design Studio is best used by downloading and installing our native desktop applications. There is a web browser test environment but it is not recommended for up-to-date functionality.

Q: How do I download Zoo Design Studio?

Visit our downloads page to install the desktop application.

Q: How much does Zoo Design Studio cost?

Zoo Design Studio is available for free but also has paid tiers for professionals, teams, and enterprises. You can view our pricing here.

Q: Do I need a traditional CAD license to use Zoo Design Studio?

No. Zoo Design Studio is CAD software that anyone can use and download for free. There are paid subscription tiers that unlock more powerful features and capabilities, like unlimited Zookeeper credits and support for teams and enterprises. Visit our pricing page for more details.

Q: Does Zoo Design Studio require an internet connection?

Yes. Zoo Design Studio requires an internet connection because processing and our geometry engine run in the cloud. This lets you handle complex CAD workflows smoothly, even on low-powered machines.

Core Features

Q: What CAD modeling features does Zoo Design Studio have?

Zoo Design Studio has solid modeling features like extrude, revolve, sweep, booleans, etc. For a full list of features, visit our documentation.

Q: Does Zoo Design Studio support assemblies?

Yes. Assemblies are supported in Zoo Design Studio as of v1.0.

Q: How often is Zoo Design Studio updated?

We constantly ship updates to Zoo Design Studio. We do not currently follow a scheduled release cadence—this allows us to release exciting features and bug fixes as quickly as we can.

Q: What file types can I import into Zoo Design Studio?

These are the current file types that are compatible with Zoo Design Studio:

  • STEP/STP
  • SLDPRT
  • KCL
  • STL
  • glTF/GLB
  • OBJ
  • FBX
  • PLY
Q: What file types can I export from Zoo Design Studio?

You can export your project into the following file types:

  • STEP
  • STL
  • glTF
  • OBJ
  • PLY
  • FBX

Zookeeper In Zoo Design Studio

Q: What is Zookeeper, and how does it use Text-to-CAD?

Zookeeper is the built-in AI CAD assistant in Zoo Design Studio that helps you design, edit, and understand 3D models using the KittyCAD Language (KCL). When you request a change to your CAD model, Text-to-CAD is one of the tools Zookeeper uses to convert it into parametric KCL code and update the active project. This produces editable, parameterized designs you can iterate on quickly.

Q: Who can benefit from using Zookeeper?

Zookeeper is designed to benefit a wide range of users, from beginners and non-engineers to expert CAD professionals and enterprise teams. It speeds up design by turning plain text requests into editable parametric KCL models for newcomers, while saving experts time with rapid prototyping, project-aware edits, and repeatable workflows that scale for teams.

Q: Where is Zookeeper in Zoo Design Studio?

Zookeeper is a pane on the right side. Click the sparkles icon in the right control bar to open it. It's context-aware and works with your active project to create or edit designs.

Q: What types of CAD models can Zookeeper generate?

Zookeeper can generate a wide range of CAD models, from simple primitives and brackets to mechanical parts, enclosures, mounts, assemblies, and 3D-printable components, all from prompts. It can also edit existing models, interpret selected geometry and renders, and update the active project by producing or modifying parametric KCL code.

Q: Is Zookeeper Text-to-CAD?

Yes - Text-to-CAD is one of the core tools Zookeeper uses to turn your natural-language requests into parametric KCL models, but Zookeeper also provides context-aware edits, guidance, and CAD expertise beyond just generation.

Q: Can Zookeeper model things directly from text prompts?

Yes - Describe what you want and Zookeeper will try to generate the geometry as parametric KCL. If generation fails or needs tweaking, it will suggest prompt refinements or follow-up edits.

Q: Can Zookeeper suggest my next steps during modeling?

Yes - Zookeeper analyzes your active project and offers context-aware suggestions (e.g., add fillets, mounting holes, or adjust dimensions) to help you decide the next modeling steps. It can also propose small edits or refinements you can apply immediately.

Q: Can Zookeeper interpret selections I make in the project?

Yes - Zookeeper understands and uses your selections in the active project. When you select faces, edges, bodies, or code regions, Zookeeper uses that context to make targeted edits, add features, or generate more precise prompts.

Q: Can Zookeeper view and interpret renders of my model?

Yes - Zookeeper can view and interpret the project's renders and multiview snapshots to understand geometry and suggest or make context-aware edits. It uses those visual cues alongside selections and KCL to produce more accurate modifications.

Q: Can you ask Zookeeper questions?

Yes - You can ask Zookeeper questions about modeling, KCL, design decisions, or your active project. It will answer with guidance, explain steps, and can perform edits or generate models when you request them.

Q: How does a user get the most value from Zookeeper?

Be specific about what you want (dimensions, constraints, intended use) and include selections or reference geometry in the active project - clear prompts produce more accurate KCL results. Iterate: review the generated model, tweak parameters or ask for targeted edits, and accept Zookeeper's suggestions (fillets, holes, thickness changes) to quickly refine the design.

Q: What languages does Zookeeper understand?

Zookeeper understands natural-language prompts (primarily English) and can read and work with KCL code and selected geometry in your project. It also accepts many major languages (Spanish, French, German, Chinese, etc.) with varying accuracy, though the best results are typically in English.

KCL & Code-Based Cad Design

Q: What is KCL and what is it used for?

KCL (KittyCAD Language) is Zoo's own scripting language for describing CAD geometries and rendering them within Zoo Design Studio. Every CAD function in Zoo Design Studio generates KCL. Using KCL in Zoo Design Studio is completely optional and is not required. KCL allows designers to leverage the benefits of code in the CAD ecosystem.

Q: Do I need to know how to code in KCL to use Zoo Design Studio?

No! Coding with KCL (Zoo's CAD coding language) is completely optional. However, it can be quite powerful. If your curiosity gets the best of you, you can learn more about getting started with KCL for coding in CAD Community Page.

Developer Tools

Q: Is Zoo Design Studio Open Source?

Yes, the Zoo Design Studio application is open source and you can find it on GitHub. However, our CAD geometry engine is not open source.

Q: I want to build a custom CAD application with Zoo's APIs, where can I start?

Check out our developer documentation to get started designing your own modeling tools.

Support & Updates

Q: Where can I go if I need help?

For assistance, check out our Community Page! See if others have asked for help with the same thing and if not, make a new topic so we can help you. Users who are on a paid plan can use email support or submit a support ticket here if they are logged in.

Q: I found a bug, where can I report it?

There are a few places you can report a bug. You can report it on our Community Page, you can let us know on our Discord, or if you are familiar with GitHub, you can make an issue for us.

Q: How do I update Zoo Design Studio?

Updates will download automatically the next time you open Zoo Design Studio. Once the update is complete, you will need to restart your application for it to take affect.

Q: I have a feature request, where can I tell the team?

You can use our Community Page to see if someone else has requested the same thing. If no one has, make a new request using the feature category.

Design Studio Pricing

Pricing, Billing, Payment

Q: What's included in the Free Plan, and how do I know when to upgrade?

With the Free Plan, you get full access to Zoo Design Studio. Text-to-CAD is limited to 1,205 credits per month, and Zoo may use your data to improve our products. We'll let you know when you're out of credits, and you can upgrade anytime from your account.

Q: Do you offer monthly and annual payment options, and are there discounts for yearly plans?

We do! You can pay month-to-month and contact us to cancel any time. If you opt for an annual plan, you get a 20% discount in exchange for paying upfront and remaining committed to that plan for an entire year.

Q: Which payment methods are accepted, and can they be changed later?

We accept credit cards for all paid plans. For Team or Enterprise plans, if you need custom billing, please contact us.

Q: Can I switch between plans anytime without losing data?

Yes, you can always upgrade or downgrade your plan to another tier without losing your data.

Q: If I upgrade to an annual plan from a monthly plan, is my payment pro-rated?

Yes, we will apply the remaining number of days on your monthly plan towards the annual plan's price at checkout.

Support & Usage

Q: What onboarding resources or training do you provide for new users?

Check out our documentation and tutorials to learn more. Free users can access our Community Support Forum or join our Discord server for additional support.

Q: Are there usage caps on the Free Plan, and how do overages work?

On the Free Plan, Zookeeper credits are capped at 1,205 per month. Zookeeper credits reset on the first of every month. If you go over in a given month, you won't be able to use Zookeeper again until the first day of the following month, or you can upgrade to any of our paid plans and get unlimited Zookeeper credits!

Enterprise Solutions

Q: What does the Enterprise Plan cost and is custom or volume-based pricing available for large teams?

Please contact us to discuss pricing and features for your company. We will work with you to craft a plan that optimizes value and works best to fit your goals.

Q: Can the platform handle complex workflows, and whom do I contact for enterprise-level needs?

If you're an enterprise user, we'd love to learn more about your custom workflows. Please contact us so we can discuss.

Q: Can I customize, train, or fine tune Text-to-CAD on my company's CAD data?

Yes! This is extremely powerful and can provide significant value for organizations with large CAD operations. Contact our team to learn more about how we can help.

Data Security & Api Integration

Q: How do you safeguard user data and ensure compliance with industry standards?

Zoo is in the process of obtaining SOC2 Type II certification (expected by Q4 2025). Zoo adheres to industry standards for safeguarding your data.

Q: Which third-party apps or APIs does the platform integrate with?

Zoo offers a full suite of APIs that can connect to any platform. Please refer to our developer documentation for more information.

API Pricing

Pricing

Q: How much do API calls cost?

API calls are charged by the second. Each second costs ~$0.0083.

Rounding: We compute elapsed_seconds x $1/120, then round Half-Up to the nearest cent per call. We never round the time itself.

Short calls policy: Historically, sub-10-second calls were not billed. Starting October 14, 2025, we will bill them per second with the same rate and rounding.

Note: because we round each call to cents, many tiny calls can sum to a hair more than one long call with the same total seconds. This is standard for usage billing. If that ever meaningfully impacts you, tell us.

For more information on how the math works, see Jess's blog post here.

Q: How many free API calls do I get?

All users get $10.00 worth of API calls per month for free. After that, it is pay-as-you-go pricing.

Q: Do all API calls cost the same?

Yes, all of our charged API calls are charged by the second. Each second costs ~$0.0083. For more information on how the math works, see Jess's blog post here.

Q: Am I charged for failed API calls?

No, you are not charged if the API call fails.

Q: Am I charged for GET API calls?

Generally no. GET requests are free, except for WebSocket-style GETs used for real-time features: endpoints that start with /ws/modeling/commands or contain /ws/ml/copilot are billable.

Q: Which endpoints are billed?

In general, any POST endpoint is billable unless it is on our exclusion list below. The only GET endpoints that are billable are WebSocket-style GETs for real-time features: endpoints that start with /ws/modeling/commands or contain /ws/ml/copilot.

Based on our current API specification (spec.json), representative billable POST endpoints include:

  • /ai/text-to-cad/{output_format}

  • /ml/kcl/completions

  • /ml/text-to-cad/iteration

  • /ml/text-to-cad/multi-file/iteration

  • /ml/convert/proprietary-to-kcl

  • /file/conversion

  • /file/conversion/{src_format}/{output_format}

  • /file/mass

  • /file/volume

  • /file/surface-area

  • /file/density

  • /file/center-of-mass

This list is not exhaustive; new billable endpoints may be added in the future. Always refer to the API spec and this FAQ for the latest billing behavior.

Q: Are endpoints that start with /user or /org billed?

No. Endpoints that start with /user or /org are free and not billed.

Q: Are /oauth2 endpoints billed?

No. Endpoints that start with /oauth2 are free and not billed.

Q: Which endpoints are never billed?

The following endpoints are free and never billed:

  • /_meta
  • /user
  • /logout
  • /apps
  • /events
  • /org
  • /store
  • /_internal
  • /auth
  • /oauth2
  • /debug
  • Any endpoint containing shortlinks
  • /file/execute/
  • /ws/ml/reasoning/{id}

Machine Learning Apis

Q: How long do Text-to-CAD API calls take?

Text-to-CAD generations can vary in their duration. It depends on the complexity of your prompt. A large majority of Text-to-CAD API calls last between 10 - 30 seconds. However, they can last minutes if the prompt is long and complex.

Q: The result from Text-to-CAD wasn't great, am I still charged?

Yes. We are working on our machine learning endpoints every day, but it is still experimental. Some results may not be as good as you expect.

Q: What file format does Text-to-CAD output?

Text-to-CAD includes a STEP file and can optionally output KCL as well with every call. For any other file format, you will be charged for the file conversion API used.

Support

Q: Where can I get help with using Zoo APIs?

For assistance with APIs, you can ask a question on our Community Page or discuss on our Discord!

Q: I think I found a bug, where can I report it?

For bugs, mention it to us on our Community Page.

Q: We need help deploying a large scale API service using Zoo APIs within our company. Who is the best person to contact?

Please email us directly. We would love to chat with your specific needs and see how we can best help you.

You can also find answers to your questions in our FAQ Center. If you have any other questions, feel free to reach out to us through our support channels.

FAQ
Browse our frequently asked questions to find quick answers to common inquiries.