Skip to content
UltimateTeam.ai Docs

Register Model

POST
/api/v1/finetuning/models/{tenant_id}

Register a new fine-tuned model version.

Creates a new version in draft status. Enterprise-only.

Authorizations

Parameters

Path Parameters

tenant_id
required
string format: uuid

Request Body required

Request body for registering a new fine-tuned model version.

object
base_model
required

Base model identifier (e.g. ‘gpt-4o-2024-08-06’).

string
>= 1 characters <= 200 characters
evaluation_metrics

Initial evaluation metrics from training (loss, etc.).

object
key
additional properties
any
hyperparameters

Training hyperparameters (epochs, learning_rate, etc.).

object
key
additional properties
any
provider
required

LLM provider (openai, google, anthropic).

string
>= 1 characters <= 50 characters
provider_model_id
Any of:
string
<= 500 characters
training_data_hash
required

SHA-256 hash of the training dataset for reproducibility.

string
>= 1 characters <= 128 characters

Responses

201

Successful Response

Response body for a fine-tuned model version.

object
base_model
required
string
canary_traffic_pct
integer
created_at
required
string format: date-time
deployment_status
required
string
evaluation_metrics
required
object
key
additional properties
any
hyperparameters
required
object
key
additional properties
any
id
required
string format: uuid
promoted_at
Any of:
string format: date-time
promoted_by
Any of:
string
provider
required
string
provider_model_id
Any of:
string
retired_at
Any of:
string format: date-time
rolled_back_at
Any of:
string format: date-time
tenant_id
required
string format: uuid
training_data_hash
required
string
version_number
required
integer

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string