ID Photo Generator
Provides an ID photo generator API, enabling developers to quickly create passport and ID photos and seamlessly integrate them into business systems.
Documentation
ID Photo Generator API Overview
The ID Photo Generator API helps developers quickly process and create ID photos within their systems. It returns structured results and is ideal for content processing, automated production, and business integration.
Use Cases
- Integrate ID photo generation capabilities into internal systems, SaaS platforms, automated workflows, or admin dashboards.
- Suitable for business scenarios requiring stable API calls, standardized responses, and orchestratable interfaces.
- We recommend implementing rate limiting, failure retries, and result caching strategies to improve overall integration stability.
Integration Guidelines
- Verify request parameter formats, authentication methods, and error code handling logic before integration.
- For high-frequency generation scenarios, ensure proper log tracking, timeout controls, and idempotency handling.
- If the results are used for risk control or automated decision-making, we recommend applying secondary checks based on your business rules rather than relying solely on the API response.
Integration Examples
Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.
Request Example
{
"url": "https://example.com/photo.jpg",
"spec": "1inch",
"bgColor": "white",
"dpi": 300
}Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"resultUrl": "https://example.com/result.jpg",
"width": 295,
"height": 413
}
}Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| url | string | https://example.com/photo.jpg |
| spec | string | 1inch |
| bgColor | string | white |
| dpi | number | 300 |
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.resultUrl | string | https://example.com/result.jpg |
| data.width | number | 295 |
| data.height | number | 413 |