v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22216424765.0 KB
gateway.openapi_Gateway

Create Reinforcement Fine-tuning Job

post/v1/accounts/{account_id}/reinforcementFineTuningJobs

Path parameters

account_idstring required

The Account Id

Query parameters

reinforcementFineTuningJobIdstring

ID of the reinforcement fine-tuning job, a random UUID will be generated if not specified.

Request body

namestring
displayNamestring
createTimestring date-time
completedTimestring date-time

The completed time for the reinforcement fine-tuning job.

datasetstring required

The name of the dataset used for training.

evaluationDatasetstring

The name of a separate dataset to use for evaluation.

evalAutoCarveoutboolean

Whether to auto-carve the dataset for eval.

state'JOB_STATE_UNSPECIFIED' | 'JOB_STATE_CREATING' | 'JOB_STATE_RUNNING' | 'JOB_STATE_COMPLETED' | 'JOB_STATE_FAILED' | 'JOB_STATE_CANCELLED' | 'JOB_STATE_DELETING' | 'JOB_STATE_WRITING_RESULTS' | 'JOB_STATE_VALIDATING' | 'JOB_STATE_DELETING_CLEANING_UP' | 'JOB_STATE_PENDING' | 'JOB_STATE_EXPIRED' | 'JOB_STATE_RE_QUEUEING' | 'JOB_STATE_CREATING_INPUT_DATASET' | 'JOB_STATE_IDLE' | 'JOB_STATE_CANCELLING' | 'JOB_STATE_EARLY_STOPPED' | 'JOB_STATE_PAUSED'

JobState represents the state an asynchronous job can be in.

  • JOB_STATE_PAUSED: Job is paused, typically due to account suspension or manual intervention.
createdBystring

The email address of the user who initiated this fine-tuning job.

evaluatorstring required

The evaluator resource name to use for RLOR fine-tuning job.

outputStatsstring

The output dataset's aggregated stats for the evaluation job.

chunkSizeinteger

Data chunking for rollout, default size 200, enabled when dataset > 300. Valid range is 1-10,000.

outputMetricsstring
mcpServerstring
maxInferenceReplicaCountinteger
nodeCountinteger

The number of nodes to use for the fine-tuning job. If not specified, the default is 1.

trainerLogsSignedUrlstring

The signed URL for the trainer logs file (stdout/stderr). Only populated if the account has trainer log reading enabled.

acceleratorSecondsobject

Accelerator seconds used by the job, keyed by accelerator type (e.g., "NVIDIA_H100_80GB"). Updated when job completes or is cancelled.

maxConcurrentRolloutsinteger

Maximum number of concurrent rollouts during the RFT job.

maxConcurrentEvaluationsinteger

Maximum number of concurrent evaluations during the RFT job.

Response

A successful response.

namestring
displayNamestring
createTimestring date-time
completedTimestring date-time

The completed time for the reinforcement fine-tuning job.

datasetstring required

The name of the dataset used for training.

evaluationDatasetstring

The name of a separate dataset to use for evaluation.

evalAutoCarveoutboolean

Whether to auto-carve the dataset for eval.

state'JOB_STATE_UNSPECIFIED' | 'JOB_STATE_CREATING' | 'JOB_STATE_RUNNING' | 'JOB_STATE_COMPLETED' | 'JOB_STATE_FAILED' | 'JOB_STATE_CANCELLED' | 'JOB_STATE_DELETING' | 'JOB_STATE_WRITING_RESULTS' | 'JOB_STATE_VALIDATING' | 'JOB_STATE_DELETING_CLEANING_UP' | 'JOB_STATE_PENDING' | 'JOB_STATE_EXPIRED' | 'JOB_STATE_RE_QUEUEING' | 'JOB_STATE_CREATING_INPUT_DATASET' | 'JOB_STATE_IDLE' | 'JOB_STATE_CANCELLING' | 'JOB_STATE_EARLY_STOPPED' | 'JOB_STATE_PAUSED'

JobState represents the state an asynchronous job can be in.

  • JOB_STATE_PAUSED: Job is paused, typically due to account suspension or manual intervention.
createdBystring

The email address of the user who initiated this fine-tuning job.

evaluatorstring required

The evaluator resource name to use for RLOR fine-tuning job.

outputStatsstring

The output dataset's aggregated stats for the evaluation job.

chunkSizeinteger

Data chunking for rollout, default size 200, enabled when dataset > 300. Valid range is 1-10,000.

outputMetricsstring
mcpServerstring
maxInferenceReplicaCountinteger
nodeCountinteger

The number of nodes to use for the fine-tuning job. If not specified, the default is 1.

trainerLogsSignedUrlstring

The signed URL for the trainer logs file (stdout/stderr). Only populated if the account has trainer log reading enabled.

acceleratorSecondsobject

Accelerator seconds used by the job, keyed by accelerator type (e.g., "NVIDIA_H100_80GB"). Updated when job completes or is cancelled.

maxConcurrentRolloutsinteger

Maximum number of concurrent rollouts during the RFT job.

maxConcurrentEvaluationsinteger

Maximum number of concurrent evaluations during the RFT job.