STL Converter API

基础 URL 与访问

Use the same origin that serves this page as the API base URL. Each job returns a capability token in the JSON response; send it in the X-Job-Token header for status and cancellation. Bind jobs to an authenticated account and enforce plan quotas before sharing the service publicly.

const API_BASE = 'https://convertostl.com';

接口

• GET /api/health checks availability and reports queue, upload, and in-process conversion metrics.
• POST /api/jobs accepts multipart fields operation, outputFormat, options, and one or more file fields.
• GET /api/jobs/:id returns queued, processing, completed, or failed status plus mesh analysis.
• DELETE /api/jobs/:id cancels a queued job before processing starts.
• GET /api/jobs/:id/download downloads the completed result.

创建转换任务

JavaScript clients can send the same multipart fields with FormData:

curl -X POST https://convertostl.com/api/jobs -F operation=convert -F outputFormat=stl -F [email protected]

const form = new FormData();
form.append('operation', 'convert');
form.append('outputFormat', 'stl');
form.append('file', file);
const response = await fetch(`${API_BASE}/api/jobs`, { method: 'POST', body: form });
const job = await response.json();

Multipart 字段

轮询并下载

Poll the status URL with the X-Job-Token header until it returns completed or failed. A completed response includes a relative result.downloadUrl containing a separate download-only token that expires after 10 minutes. API clients can also download with the original capability in the header.

curl -H "X-Job-Token: JOB_TOKEN" https://convertostl.com/api/jobs/JOB_ID
# Use the result.downloadUrl returned by the completed response:
curl -L -o result.stl "https://convertostl.com/api/jobs/JOB_ID/download?download_token=DOWNLOAD_TOKEN"

错误代码

支持的工作流与限制

Supported inputs include STL, OBJ, 3MF, GLB, FBX, STEP, IGES, DAE, PLY, BLEND, PNG, JPG, SVG, DXF, and ZIP. Reverse exports support OBJ, GLB, FBX, faceted STEP, and 3MF; ASCII STL can be normalized to Binary STL. Compress, reduce, split, and merge are real server operations: compression removes redundant geometry, reduction keeps a controlled triangle ratio, split returns connected components in a ZIP, and merge combines input surfaces into one STL without Boolean union. SCAD and STL to G-code remain guides because they require OpenSCAD or a printer-specific slicer. Uploads are limited to 250 MB; ZIP jobs also have file-count and decompressed-size limits.

ZIP archives accept up to 100 nested files and a 128 MB decompressed/output safety budget by default. Mesh processing also enforces vertex and face limits. The default rate limit is 20 job creations per client per minute, with one active conversion and two pending jobs on the reference deployment.

Jobs and temporary files are retained only for the one-hour cleanup window. Download URLs expire after 10 minutes. Add authentication, aggregate edge rate limiting, request timeouts, a persistent result store, and container-level memory limits before exposing the API to an untrusted public network.