LINA AI Virtual Face API Documentation

Overview

This API provides access to AI-generated virtual models created by lina.photos. Each model group contains multiple facial expressions and poses of the same virtual model.

Endpoint

GET https://lina.photos/face/

Request Parameters

Query Parameters

Parameter	Type	Required	Default	Description
page	integer	No	1	Page number to retrieve virtual model groups
limit	integer	No	25	Number of virtual model groups per page

Response

Success Response (200 OK)

{
    "status": "success",
    "data": {
        "groups": [
            {
                "upload_target_srl": "string",
                "files": [
                    {
                        "file_srl": "string",
                        "sid": "string",
                        "face_url": "string"
                    }
                ]
            }
        ],
        "pagination": {
            "current_page": "integer",
            "total_pages": "integer",
            "total_records": "integer",
            "limit": "integer"
        }
    }
}

Response Fields

data.groups

Field	Type	Description
upload_target_srl	string	Unique identifier for the virtual model group
files	array	List of different poses and expressions of the virtual model

data.groups[].files

Field	Type	Description
file_srl	string	Unique identifier for the specific virtual model image
sid	string	Session identifier of the virtual model generation
face_url	string	Complete URL to access the virtual model image

data.pagination

Field	Type	Description
current_page	integer	Current page number
total_pages	integer	Total number of pages
total_records	integer	Total number of virtual model groups
limit	integer	Number of groups per page

Error Response (500 Internal Server Error)

{
    "status": "error",
    "message": "string"
}

Example

Request

GET https://lina.photos/face/?page=1&limit=25

Success Response

{
    "status": "success",
    "data": {
        "groups": [
            {
                "upload_target_srl": "12345",
                "files": [
                    {
                        "file_srl": "100",
                        "sid": "abc123",
                        "face_url": "https://lina.photos/files/attach/images/2025/02/07/fe0867a20447c8da38d6fee75d87126a.jpg"
                    }
                ]
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 10,
            "total_records": 250,
            "limit": 25
        }
    }
}

Notes

All responses are returned in JSON format
Each virtual model group can contain multiple poses and expressions
Virtual models are sorted by creation date in descending order
Images are hosted on lina.photos domain
All virtual models are AI-generated by lina.photos

LINA AI Virtual Model API Documentation