---
title: "Add Profile"
method: POST
path: "/v2/phota/profiles/add"
tags: ["Profiles"]
---

# Add Profile

`POST /v2/phota/profiles/add`

## Request

- Base URL: `https://api.photalabs.com`
- URL: `https://api.photalabs.com/v2/phota/profiles/add`
- Auth: API key in header `X-API-Key`

Create a new profile from signed image URLs.

Starts training asynchronously and returns a profile ID immediately.
Poll `GET /profiles/{profile_id}/status` to check when training completes.

## Request body

- AddProfileRequest: 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.
  - `training_tier` 'standard' | 'fast': Training tier for a profile job. Attributes: STANDARD: Full-quality training (10-50 images, 500-1000 steps scaled by image count). FAST: Reduced-image, faster-turnaround training (5-10 images, 150-300 steps scaled by image count).
  - `tag` string, nullable: Optional immutable tag to group or namespace this profile (e.g., your end-user's identifier).
  - `model_version` 'v1' | 'v2': Personalization model version a profile is trained on. Attributes: V1: The original personalization model. V2: The current personalization model.

## Response `200`

Successful Response

- AddProfileResponse: Response returned after a profile is created.
  - `profile_id` string, required: Unique identifier for the new profile. Use this to poll training status.

## Other responses

- `401`: Invalid API key in the X-API-Key header.
- `402`: Insufficient prepaid credit balance.
- `403`: Missing X-API-Key header (no API key provided).
- `404`: Resource not found.
- `422`: Validation Error
- `500`: Internal error.

---

[API](https://skmtc.dev/photalabs/apis/phota-api.md) - [All operations](https://skmtc.dev/photalabs/apis/phota-api/llms.txt) - [OpenAPI document](https://skmtc.dev/photalabs/apis/phota-api/revisions/951f156f1f6c?raw)