FAQ

AI Data Foundry uses Synap Office account login.

Registration Process

1. Click [Sign Up] button at the top right of the page
2. Create Synap Office account
3. Automatic login and 300 free welcome credits granted

Yes, 300 welcome credits are automatically granted upon registration.

Free Test Benefits

• Free trial of document analysis and conversion features with welcome credits
• Can recharge credits at Pricing page if more credits needed

API keys can be created and managed on the Workspace > API Keys page.

API Key Issuance Process

1. Click [+ Create New API Key] button
2. Enter API key name (e.g., "Development Key", "Production Key")
3. Securely copy and store the generated API key

Important: API keys are displayed only once upon creation, so be sure to save them in a secure location.

Supported File Formats

Yes, the maximum size for a single file is 100MB.

If you attempt to upload a file exceeding this size, a 413 Payload Too Large error will occur.

Currently, the API processes only one file at a time.

Multiple File Processing Method

To process multiple files, you must call the API individually for each file.

Processing Method

The /analyze endpoint operates in a synchronous manner:

• When you send a request, it waits until the server completes analysis
• Upon completion, you immediately receive the result ZIP file as a response
• Processing time varies depending on document size and page count

No separate status query API is provided.

Troubleshooting

Please check the following:

1. Verify API key is included in request header

   Authorization: Bearer {API_KEY}

2. Verify API key is valid (not expired)
3. Verify API key hasn't been deleted

Cause

The file you're trying to upload exceeds 100MB.

Solution

Reduce the file size or split it into multiple files for upload.

Cause

Unsupported file format.

Solution

Check supported file formats and upload files in the correct format.

API Endpoint

AI Data Foundry provides a single endpoint:

POST /api/v1/docu-analyzer/analyze

Key Features

• Upload document file and immediately receive analysis results
• Synchronous method: Waits until analysis completes, then returns result as ZIP file
• No separate status query or callback needed

Request Examples

cURL

curl -X POST 'https://foundry.synap.kr/api/v1/docu-analyzer/analyze' \
  -H 'Authorization: Bearer {API_KEY}' \
  -F 'file=@{FILE_PATH}' \
  -o result.zip

Python

import requests

api_key = "{API_KEY}"
file_path = "/path/to/your/file.ext"
url = "https://foundry.synap.kr/api/v1/docu-analyzer/analyze"

headers = { "Authorization": f"Bearer {api_key}" }

with open(file_path, "rb") as file:
    files = { "file": file }
    response = requests.post(url, headers=headers, files=files)

with open("result.zip", "wb") as f:
    f.write(response.content)

Node.js

const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');

const apiKey = "{API_KEY}";
const filePath = "/path/to/your/file.ext";
const url = 'https://foundry.synap.kr/api/v1/docu-analyzer/analyze';

const form = new FormData();
form.append('file', fs.createReadStream(filePath));

const headers = {
  ...form.getHeaders(),
  'Authorization': `Bearer ${apiKey}`,
};

axios.post(url, form, {
    headers: headers,
    responseType: 'stream'
}).then(response => {
    response.data.pipe(fs.createWriteStream('result.zip'));
}).catch(error => {
    console.error('Error:', error.response?.data || error.message);
});

Response

ZIP file containing analysis results (includes JSON, Markdown, XML formats)

Credits are a prepaid currency for using AI Data Foundry features.

• Credits are deducted based on the number of pages during document analysis
• Credits can be recharged at Pricing

Waterfall Method

Credits are deducted in the following order:

1. Welcome Credits: Free credits received upon registration
2. Subscription Credits: Credits received from monthly/annual subscription plans
3. One-time Purchase Credits: Credits purchased individually

Welcome credits are used first, then subscription credits, and finally one-time purchase credits.

You can check your real-time balance at the top right of the web interface.

No separate endpoint is provided for querying credits via API.

No. Credits are not deducted if the API request fails.

Credits are deducted only when document analysis is successfully completed.

Error Received

When credits are insufficient, you'll receive the following error response:

{
  "message": "Insufficient credits to perform document analysis.",
  "error": "Payment Required",
  "statusCode": 402
}

Solution

Recharge credits at Pricing and try again.

File Storage Policy

Uploaded files are immediately deleted after analysis completion:

• Original files: Automatically removed from the server after analysis
• Analysis results: Not stored on the server after ZIP file is received in API response
• Client storage: Only result files received by user are kept on client side

Data Protection Policy

No. Data uploaded by users:

• Is only used for document analysis and conversion purposes
• Is never used for AI model training
• Is not shared with third parties

API Key Security Guidelines

Follow these practices for API key security:

1. Never expose publicly: Do not expose in GitHub, client code, etc.
2. Use environment variables: Manage via .env file or environment variables
3. Regular renewal: Periodically reissue API keys and delete old keys
4. Separate by purpose: Manage development and production API keys separately
5. Delete unused keys: Immediately delete API keys that are no longer in use

Emergency action: If an API key is leaked, immediately delete it at Workspace > API Keys.

Troubleshooting Steps

1. Check error message: Most error messages clearly explain the cause of the problem
2. Check API documentation: Verify correct request format in Swagger UI (/api/docs)
3. Search FAQ: Search this page for similar issues
4. Contact customer support: If unresolved, contact customer support

You can suggest the following through customer support page:

• New feature requests
• Existing feature improvements
• UI/UX improvement suggestions
• Bug reports

Enterprise plans are available for high-volume users.

For details, please contact customer support.