Custom models and locations

POST/v1/models

POST/v1/locations

Creates a custom AI model that keeps the same face across your catalogue, or a custom location for your brand's look. 40 credits each, within your plan's limit (Pro and Business 50, Enterprise 100 of each). It answers 202 with a generation of type model or location; when it succeeded, output is the new model or location, ready to use as model_id or location_id.

descriptionstringoptional

3 to 1500 characters describing the model or place. Needed unless you send reference_image.

reference_imageobjectoptional

A reference photo: { "url": "https://…" } or { "upload_id": "upl_…" }. Needed unless you send description.

namestringoptional

Up to 60 characters. Without one, we name it.

metadataobjectoptional

Your own references, returned unchanged.

webhook_urlstringoptional

An https address we call once when this generation ends: succeeded, failed or canceled. The call carries only its id, type and status, not the result, and isn't signed, so read the result with GET /v1/generations/{id}. See Webhooks.

curl

curl https://api.fittins.ai/v1/models \
  -H "Authorization: Bearer $FITTINS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Our brand model",
  "description": "woman in her late twenties, short black hair, warm smile"
}'

output when succeeded

{
  "id": "mdl_own_proj_char_1794169450184_k2p9x4",
  "object": "model",
  "source": "custom",
  "name": "Our brand model",
  "image_url": "https://api.fittins.ai/v1/files/file_8a1d0c3e5f7b9d2c4e6a8b0d/content?expires=1793905382&sig=Qa9…",
  "created_at": "2026-11-08T17:03:02.000Z"
}

Delete a custom model or location

DELETE/v1/models/{id}

DELETE/v1/locations/{id}

Deletes one of your own (mdl_own_… or loc_own_…) with its files, the same as deleting it on fittins.ai, which also frees a place within your plan's limit. It answers { "id": "…", "object": "model", "deleted": true }.

Library models and locations can't be deleted: 400 invalid_request.
One that a queued or running generation uses can't be deleted until it finishes: 409 generation_running.
Test keys check the id and answer as if it was deleted, without deleting anything.

Questions? Email support@fittins.ai with the X-Request-Id of the request.Next: Webhooks →