AI Photobook API Documentation

Overview

Produce a series of stylised portrait photos with consistent subject identity across different poses, outfits, or backgrounds.

Primary Endpoint

POST/api/v1/userPhotobook/start

Start photobook generation

Request Parameters

Name	Type	Required	Description
name	string	No	Display name for this photobook batch
face_image_url	string	Yes	Source face image URL used for all generated photos
location	string	No	Scene or location prompt
clothing	string	No	Clothing prompt applied during the image edit step
total_count	enum: 4 \| 8 \| 12 \| 16	No	Total number of photos to generate

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/userPhotobook/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer Travel Album",
  "face_image_url": "https://example.com/face.jpg",
  "location": "Paris street cafe at golden hour",
  "clothing": "elegant white dress",
  "total_count": 8
}'

Related Endpoints

POST/api/v1/userPhotobook/start

Start photobook generation

GET/api/v1/userPhotobook/allRecords

Get photobook records

POST/api/v1/userPhotobook/batchDetail

Batch query task details

GET/api/v1/userPhotobook/{id}

Get photobook record detail

DELETE/api/v1/userPhotobook/{id}

Delete photobook record

Responses

200

Photobook task started successfully

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid or missing bearer token