Developer API

To authenticate your requests, you need an API key. You can generate one in your developer dashboard. Keep this key secret.

Base URL: https://swap3d-backend.onrender.com/api/v1

Upload your file using multipart/form-data. The conversion is asynchronous, so this endpoint will return a jobId immediately.

curl -X POST https://swap3d-backend.onrender.com/api/v1/openapi/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "targetFormat=gltf" \
  -F "file=@/path/to/your/model.obj"

const formData = new FormData();
formData.append('targetFormat', 'gltf');
formData.append('file', fileInput.files[0]);

const response = await fetch('https://swap3d-backend.onrender.com/api/v1/openapi/convert', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
});

const { jobId, statusUrl } = await response.json();
console.log('Conversion started:', jobId);

Use the jobId to poll the status endpoint every few seconds. Once completed, the response will contain the download URL.

{
  "status": "completed",
  "result": {
    "downloadUrl": "/api/v1/download/converted_1774486667970.gltf",
    "targetFormat": "gltf"
  }
}