STEP, DXF & SVG online in G-Code umwandeln | step2gcode

Create Upload Link

Create a short-lived link the user opens in their browser to upload a CAD file (STEP, DXF or SVG). Returns the link and an upload_id. Poll check_upload with the upload_id until it reports a file_id, then call generate_gcode. Free. Before using this, check whether you can run shell commands. If you can, do not send the user to the browser: compress the file locally and pass it to upload_file_content with encoding="gzip+base64". That works inside sandboxes without network access, which is the com

Check Upload

Check whether the user finished the browser upload. Returns the file_id once ready. Free. NEXT STEP - do not generate yet. Ask the user: 1. Which material? Offer the presets (wood, hardwood, plywood, acrylic, aluminum, steel, brass). If theirs is not among them, pick the closest preset AND set spindle_speed, feed_rate, plunge_rate and step_down yourself from known cutting data for that material and cutter. 2. Which cutter diameters do they actually own? Recommend one from that list: it must fit

Upload File Content

Upload a CAD file by writing its content out yourself. Use this only when a direct curl upload to /api/upload is not possible - that route costs you no output at all. If you must use this tool, ALWAYS compress first and pass the output as content: gzip -c "model.step" | base64 -w0 (on macOS: gzip -c model.step | base64) Do not paste the raw file. You have to write out every character you pass here, and a typical STEP solid takes you three minutes raw against twenty seconds compressed - t

Generate Gcode

Start G-code generation for an uploaded file and wait for the result. Most jobs finish within the wait, so the answer usually already carries the part dimensions and hole diameters - no polling needed. Only if it says the job is still running, call get_job_status once after a few seconds. Free - only the download is charged. BEFORE CALLING THIS, ask the user about the settings you cannot infer from the file. Two of them change the result substantially and are wrong by default more often than no

Get Job Status

Check a generation job. While it runs you get the percentage done, how long it has been running and how much time is left before the generator gives up on its own (180 s). When it fails you get the generator's own reason - pass that on to the user instead of retrying blindly. This is the ONLY correct way to wait for a job; calling generate_gcode again never helps. Free.

Preview Toolpath

Show the finished tool path as an image (top view and isometric view, cutting moves and rapids in different colours) so the user can sanity-check the job before paying. Free.

Get Download Link

Return the download link for the finished G-code. THIS is the billed step: one credit per model not paid for yet. Re-downloading the same job or a model already paid for is free. Called without confirm, this tool charges nothing and only reports what the download would cost. Show that to the user, wait for their answer, and only then call again with confirm=true. Never set confirm=true on your own initiative - it spends the user's money.

Convert Mesh To Step

Turn an uploaded STL or 3MF mesh back into a STEP solid with exact surfaces - planes, cylinders, cones and fillets instead of triangles, intersected into real edges. Free; only the download of the finished file is charged. Use this when the user has a mesh and needs CAD geometry: a hole becomes a cylinder with a diameter again, a chamfer a cone with an angle, so the part can be dimensioned, modified and machined. Typical case: the CAD source is gone and the mesh is all that is left. The answer

Get Step Download Link

Return the download link for a STEP file built by convert_mesh_to_step. THIS is the billed step: one credit per model not paid for yet. The DXF contour that comes with a 2.5D part belongs to the same part and costs nothing extra. Called without confirm, this tool charges nothing and only reports what the download would cost. Show that to the user, wait for their answer, and only then call again with confirm=true. Never set confirm=true on your own initiative - it spends the user's money.

Get Credit Balance

Show credits left on the access token and how many models are already paid for. Free.