Quickstart Guide
Get your first SmileGeni 2D API call working in under 5 minutes. This guide walks you through authentication and submitting your first image for processing.
Prerequisites
- A SmileGeni API key (format:
sk-prod-...). Request an API key if you don't have one yet. - A tool for making HTTP requests:
cURL, Postman, or any HTTP client library. - An image file to process (PNG, JPG, JPEG, GIF, BMP, or WEBP format).
To get started, you'll need a SmileGeni API key. Send us an email and we'll get you set up within 24 hours.
Base URL
All API requests are made to the following base URL:
https://eu.api.smilegeni.aiThe API is hosted in the EU (Frankfurt) region. All data is processed in this region. Additional regions may be available in the future.
Step 1: Authenticate
All requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYNever expose your API key in client-side code or public repositories. Store it in environment variables or a secrets manager.
Step 2: Send Your First Request
Submit an image using a POST request to /process_image with the image as multipart form-data:
Step 3: Handle the Response
On success, the API returns the processed image directly as binary data in the response body. The response content type will match the output image format.
Success Response
- Status:
200 OK - Body: Processed image binary data
- Content-Type: Image MIME type (e.g.,
image/png)
Error Responses
| Status Code | Meaning |
|---|---|
401 | Invalid or missing API key |
400 | Invalid request (missing image, bad parameters) |
413 | Image file too large |
500 | Server processing error |
Next Steps
- Read the full API Reference for all parameters and workflow options.
- Review the Photo Guidelines for optimal input images.
- Explore Code Examples in multiple languages.
- Set up Monitoring & Logs to track your usage.