Model APIs

Use a saved style to repeat a look, a brand kit to carry brand rules, a named motion to direct the camera, and a color preset to grade a Studio composition. These inputs affect different stages of the result and can be combined within the chosen model's capabilities.

Saved styles #

Saved styles are a reusable look: a prompt fragment plus reference images, applied with style_id.

An explicit style_id overrides the project's style for one generation. Style images follow the subject references and use only the remaining reference budget. An image that does not fit is left out; the prompt fragment still applies.

$ curl -sS https://api.nolgia.ai/v1/styles \
  -H "Authorization: Bearer $NOLGIA_TOKEN"

This response is built from SavedStyleList and SavedStyle, not a production capture.

{
  "styles": [
    {
      "id": "60825d85-9c86-4146-9715-386a1aa2743c",
      "user_id": "4961eaef-70a6-4e9b-b746-c86ad3e62077",
      "name": "Paper cut",
      "prompt_fragment": "Layered paper shapes with visible cut edges and soft side lighting.",
      "model_hint": "flux-pro",
      "reference_images": [],
      "created_at": "2026-09-21T04:00:00Z",
      "updated_at": "2026-09-21T04:00:00Z"
    }
  ]
}

Brand kits #

Brand kits are reusable palettes, fonts, logos and never-rules for generation, scoped to the personal library or the active organization.

brand_kit_mode #

Image enhancement, expansion and masked requests do not attach a brand logo. Video edit and extend tasks do not attach it either; regeneration with source_video_asset_id refuses an explicit kit and skips an implied project kit. The model's reference limits still apply.

Camera moves #

The camera-move library is public, embedded and identical for every caller. Send its stable id as motion_id on a video request; the server appends the chosen strength's exact prompt fragment as a sentence without replacing your direction.

$ curl -sS https://api.nolgia.ai/v1/motions

This is the first complete entry from an anonymous production read; the rest of motions is omitted.

{
  "motions": [
    {
      "category": "dolly",
      "default_strength": "medium",
      "description": "The camera moves toward the subject, tightening the frame.",
      "id": "push-in",
      "name": "Push-in",
      "preview_url": null,
      "strengths": [
        {
          "prompt_fragment": "Camera: a gentle, barely perceptible push-in toward the subject on a smooth dolly, the framing tightening only slightly by the last frame.",
          "strength": "subtle"
        },
        {
          "prompt_fragment": "Camera: a steady push-in toward the subject on a smooth dolly, the framing tightening from a medium shot to a close-up over the clip.",
          "strength": "medium"
        },
        {
          "prompt_fragment": "Camera: a fast, decisive push-in that drives from a wide shot to a tight close-up on the subject, momentum building to the last frame.",
          "strength": "strong"
        }
      ]
    }
  ]
}

Color presets #

Built-in color-grade presets are LUT looks for Studio compositions. Their catalog is public and identical for every caller; the render job bakes the grade into the exported MP4.

$ curl -sS https://api.nolgia.ai/v1/color-presets

This is the first complete preset from an anonymous production read; the rest of presets is omitted.

{
  "version": 2,
  "presets": [
    {
      "category": "motion",
      "description": "The modern film workhorse: tungsten balanced, warm shadows, soft highlight roll.",
      "group": "film",
      "name": "Kodak Vision3 500T",
      "slug": "kodak-vision3-500t"
    }
  ]
}

The .cube download contains the pure preset operations; manual grade adjustments are not included. Composition exports include their color-grade LUTs under luts/.

Next steps #