Alignment Projects

Start Auto-Align

Submit a target alignment score and let the system plan the run as a recursive self-improvement loop: each checkpoint is scored, and the score steers the next phase.

The system analyses your data, base model and prior train-time alignment history to build a multi-phase alignment plan.

Phases are sequenced and executed continuously. The system may apply gradient-free representation adjustments, supervised learning, reward-guided optimisation, or a combination, re-planning when the score trajectory demands it. Checkpoints are evaluated between phases, and the system revisits earlier phases if regressions surface.

Every parameter defaults to auto. You can override any of them to constrain the search, and the system performs best when given room to explore.

Path Parameters:

  • alignment_id: The alignment project to auto-align. Its base model, data and prior train-time alignment history warm-start the planning.

Request Body:

  • target_score (required): Target quality on a 0-99 scale
  • benchmark_id (optional): Benchmark that measures the achieved score against the target. Defaults to the benchmark already on the project
  • method, representations, sequencing (optional): Constrain which optimisation families run and in what order
  • max_compute_hours (optional): Upper bound on GPU hours across all phases
  • notify_on_phase_transition (optional): Notify on each phase change
  • config (optional): Take control of any part of the run, for reinforcement learning or supervised (SFT) settings: loss, optimizer, LoRA adapter, reward, advantage, reference policy, environment, dataset, sampling, training, checkpointing, evaluation, rendering and logging. Pass only what you want to pin; anything omitted stays auto and redundant settings are discarded. Every field is listed in the AutoAlignConfig schema, with a full example

Returns:

  • auto_align_id: Identifier of this request
  • alignment_id: The project it targets
  • status, message

Raises:

  • 404: If the alignment project is not found or does not belong to you

Notes:

  • Auto-alignment is an Enterprise Edition capability. The request is recorded and our team follows up; raise a support ticket to enable it
  • Once enabled, poll GET /alignment-projects/{alignment_id}/status for progress, phase transitions and intermediate scores
post/api/v3/alignment-projects/{alignment_id}/auto-align

Request

  • Base URL
    https://api.nugen.in
  • Auth
    HTTP bearer

Path parameters

alignment_idstring required

ID of the alignment project, returned when it was created

Request body

target_scorenumber required

Target alignment quality on a 0-99 scale. The system applies recursive self-improvement across phases until this score is reached or the compute budget is consumed. Targets above 85 typically cause the system to explore multiple optimisation strategies in sequence.

benchmark_idstring nullable

Benchmark used to measure the achieved score against the target. Defaults to the benchmark already on the alignment project.

methodstring nullable

Which optimisation families the system may use. On auto it selects and sequences them from the score trajectory, and may begin with one approach, move to another, and revisit earlier ones.

representationsstring nullable

How internal model representations are handled before and during alignment. On auto the system profiles the base model and picks a strategy before any gradient-based phase begins.

sequencingstring[] nullable

Explicit phase ordering. When null the system orders phases itself and may interleave or revisit them. When given, it follows the order and still controls the hyperparameters within each phase.

max_compute_hoursnumber nullable

Upper bound on GPU hours across all phases, allocated by expected marginal score gain. When null the run continues until the target.

notify_on_phase_transitionboolean nullable

Notify when the system moves between alignment phases.

Example request

{
  "target_score": 88
}

Response

Auto-alignment request accepted and recorded.

auto_align_idstring required

Identifier of the auto-alignment request.

alignment_idstring required

Alignment project the request targets.

status'RECEIVED' required

Request status. RECEIVED means the request was recorded.

messagestring required

Human-readable outcome of the request.

Changes

No recorded changes to this operation across all 1 revision of this API.