GenXR

🔐 Authentication

All requests require the following HTTP header:

Authorization: Bearer YOUR_API_TOKEN

Replace YOUR_API_TOKEN with the token you received after subscribing on AWS Marketplace.

---

💡 Example Usage Flow

• Subscribe to Identic Ai GmbH API on AWS Marketplace.
• An API key is created and stored in Secrets Manager.
• Use that API key to authenticate calls to /generates.
• Average generation time is about 1 minute, depending on image complexity.

---

🖼️ POST /generations

Creates a new 3D model generation task from the provided source image. Accepts an image file (JPG, JPEG, PNG, WEBP) and optional physical dimensions (x, y, z in millimeters). Returns a unique uuid to track the generation process and retrieve results.

Endpoint:
<https://panel.identic.ai/api/public/v1/generations>

🔧 Query Parameters

• source_image (string, required, binary):
  Source image (formats: JPG, JPEG, PNG, WEBP)

• size (object, optional):
  Dimensions in millimeters:

  • x: length
  • y: depth
  • z: height

📦 Example Request

curl -X POST <https://panel.identic.ai/api/public/v1/generations> \ -H "Authorization: Bearer {API_TOKEN}" \ -H "Accept: application/json" \ -H "Content-Type: multipart/form-data" \ -F "source_image=@01HPM4YSB5EK0PCQBEVB6B5MNT.jpg" \ -F "size[x]=100" \ -F "size[y]=50" \ -F "size[z]=30

---

🖼️ GET /generations/{uuid}

Retrieves the status and results of a previously created 3D model generation. Requires the uuid received from the POST /generations request. Returns current status (PENDING, COMPLETED, STALED), preview image, and downloadable model files ( e.g., .glb).

Endpoint:
<https://panel.identic.ai/api/public/v1/generations>

🔧 Query Parameters

• uuid (string, required, binary):
  Example: fe1a9cfc-79d0-11ef-a1a8-0242ac120004

📦 Example Request

curl <https://panel.identic.ai/api/public/v1/generations/fe1a9cfc-79d0-11ef-a1a8-0242ac120004> \ -H "Authorization: Bearer {API_TOKEN}" \ -H "Accept: application/json"

---

✅ Success Response

Media Type: application/json

{ "status": 200, "success": true, "data": [ { "uuid": "fe1a9cfc-79d0-11ef-a1a8-0242ac120004", "status": "COMPLETED", "created_at": "2023-09-01T12:34:56Z", "updated_at": "2023-09-05T08:30:00Z", "image": "https://cdn.aws.com/image/11rnadfjnadfnfaldnfajdf/1adfjadf.jpg", "files": [ { "uuid": "fe1a9cfc-79d0-11ef-a1a8-0242ac120004", "format": "glb", "url": "https://d3...lm.cloudfront.net/194/gene....3dNKNb.glb", "generation_time": "00:00:52" } ] } ] }

📛 Bad Request Response (400, 401, 404)

Error Codes Possible status codes returned by the API include:

• 400: Bad Request – The input parameters are malformed.
• 401: Unauthorized – Your YOUR_API_TOKEN is missing or invalid
• 404: Not Found – The generation with the specified uuid was not found.
• 500: Internal Server Error – An unexpected issue occurred on the server.

Media Type: application/json

{ "status": 400, "success": false, "error": { "code": "BAD_REQUEST", "message": null, "data": null } }