Train Brand Kit Recraft Style

Trigger Recraft custom-style training for a brand kit.

Calls Recraft’s create-style endpoint via Fal with the kit’s reference logos, persists the returned style_id on the kit. Once trained, every Recraft generation for this brand will use the custom style — the strongest brand anchor available.

Cost: ~$0.04 (one-shot). Subsequent generations are normal v3 cost.

Operator-only today. Future auto-trigger on brand_kit save is a follow-up; gated by cost concerns during early rollout. PR D of docs/plans/2026-05-14-logo-design-workflow-v2.md.

Returns: {"style_id": "...", "trained_at": "...", "reference_image_count": N}

Errors:

• 404 — brand kit doesn’t exist
• 400 — kit has no logo URLs; training requires at least one
• 502 — Recraft / Fal error during training

POST /api/v1/admin/brand-kits/{brand_kit_id}/train-recraft-style

Train Brand Kit Recraft Style

cURL

curl --request POST \
  --url https://api.example.com/api/v1/admin/brand-kits/{brand_kit_id}/train-recraft-style \
  --header 'Authorization: Bearer <token>'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_kit_id · string<uuid> · required

Response

200

application/json

Successful Response