Power Your Artwork Conversion with the ARt2XML API
Transform 2D artwork into 3D-ready XML format instantly using our RESTful API. Perfect for developers integrating art conversion into design tools, 3D modeling platforms, and VR/AR applications.
Authentication
Use an API key in the Authorization header for all requests.
Request Example
curl -X POST \ https://api.elnhnan.com/art2xml/v1/upload \ -H "Authorization: Bearer YOUR_API_KEY"
Conversion Endpoints
POST /v1/upload Primary
Main conversion endpointUpload an image or SVG file to convert to 3D-ready XML format.
Request Body
{
"file": "base64-encoded-artwork",
"format": "svg|png|jpeg",
"output": "xml-3d",
"resolution": 2048,
"preserve_colors": true
}
Response
{
"id": "conv_489f8b48",
"status": "completed",
"xml_file": "https://cdn.elnhnan.com/art2xml/conv_489f8b48.xml",
"processing_time": "2.3s",
"conversion_stats": {
"shapes": 450,
"polygons": 82,
"accuracy": "98.4%"
}
}
Batch Processing
Use the batch endpoint to convert multiple artworks in parallel with a single request.
POST /v1/batch Pro
Parallel processingSubmit multiple files in a single request for maximum efficiency.
Request Body
{
"jobs": [
{
"file": "base64-1",
"format": "svg"
},
{
"file": "base64-2",
"format": "png"
}
]
}
Response
{
"batch_id": "batch_a1b2c3",
"completed": true,
"results": [
{ "xml_url": "cdn_url_1", "status": "success" },
{ "xml_url": "cdn_url_2", "status": "warning" }
]
}
Common Error Codes
All errors returned in JSON format with detailed descriptions.
| Status Code | Message | Description |
|---|---|---|
| 401 Unauthorized | Invalid API Key | Your API key is missing or invalid |
| 400 Bad Request | Invalid File Format | Only SVG, PNG, and JPEG images are accepted |
| 429 Too Many Requests | Rate Limit Exceeded | Exceeded your API rate limit for this minute |
Rate Limiting
API requests are rate limited based on your plan tier:
Starter
100/m
Free tier
Pro
1,000/m
Contact Sales
Enterprise
50,000/m
Custom plans
Integrate ARt2XML in Your Workflow
Connect your 3D modeling tools, VR platforms, or digital archives to the fastest XML conversion engine available.