API Documentation

POST /api/process

Process an image with AI using a selected outfit option. The endpoint accepts an image file and an outfit option, processes the image asynchronously, and returns URLs for accessing the result.

Endpoint

Request

Content-Type

Parameters

Example Request

curl -X POST https://o2o.digicon.pro/api/process \
  -F "image=@/path/to/image.jpg" \
  -F "outfit=9.1"

// JavaScript/TypeScript (FormData)
const formData = new FormData();
formData.append('image', imageFile);
formData.append('outfit', '9.1');

const response = await fetch('/api/process', {
  method: 'POST',
  body: formData
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

{
  "success": true,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "redirectUrl": "https://o2o.digicon.pro/result/550e8400-e29b-41d4-a716-446655440000",
  "downloadUrl": "https://o2o.digicon.pro/processed/550e8400-e29b-41d4-a716-446655440000.png"
}

Response Fields

Error Responses

{
  "error": "Missing image or outfit"
}

{
  "error": "Internal Server Error"
}

Important Notes

• Asynchronous Processing: The API returns immediately with both redirectUrl and downloadUrl. Image processing happens in the background. The processed image will be available at thedownloadUrl as soon as processing completes, without requiring survey completion.
• Outfit Options: Valid outfit options follow the format X.Y(e.g., "9.1", "9.2", "9.3"). The available options correspond to the outfit images 9.1 to 9.8 available in the system.
• Image Formats: The API accepts common image formats (JPEG, PNG, etc.). The processed image will be returned as PNG.
• Request ID: Use the request_id to track your request. The processed image filename will be {request_id}.png.
• Redirect URL vs Download URL:
  • redirectUrl: Points to the survey/result page. Use this URL to generate QR codes that users can scan to access the survey and view their processed image.
  • downloadUrl: Direct URL to the processed image file. The image is available at this URL immediately when processing completes, independent of survey completion. You can use this URL to display or download the image programmatically.