Skip to main content
POST
/
v1
/
phota
/
profiles
/
add
Add Profile
curl --request POST \
  --url https://api.photalabs.com/v1/phota/profiles/add \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "image_urls": [
    "<string>"
  ],
  "training_tier": "standard",
  "tag": "<string>"
}
'
{
  "profile_id": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Request body for creating a new profile.

​
image_urls
string[]
required

Publicly accessible URLs pointing to the training images. Supported formats: JPEG, PNG, WebP, and HEIC/HEIF. Images larger than 4K (4096px) are automatically resized; for best results, provide images at 4K or below. PNG images are transcoded to JPEG (quality 95) for storage efficiency. Image-count range depends on training_tier: "standard" requires 10–50, "fast" requires 5–10.

Required array length: 5 - 50 elements
​
training_tier
enum<string>
default:standard

Training tier for the profile. "standard" trains on 10–50 images for highest quality; "fast" trains on 5–10 images for quicker turnaround at lower cost.

Available options:
standard,
fast
​
tag
string | null

Optional immutable tag to group or namespace this profile (e.g., your end-user's identifier).

Required string length: 1 - 128

Response

Successful Response

Response returned after a profile is created.

​
profile_id
string
required

Unique identifier for the new profile. Use this to poll training status.