Skip to main content
POST
Create model resources

Authorizations

Authorization
string
header
default:default
required

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

Body

application/json

Request to provision a standalone model resource

base_model
string
required

Base model to provision the resource for, selected from /rl/supported-models

Example:

"Qwen/Qwen3.5-4B"

base_weights_ref
string

Model in this project's model registry whose weights the resource trains in place of the base model's own. It must be a full-weight model.

Maximum string length: 256
Pattern: ^together://ml_[A-Za-z0-9]+(@rv_[A-Za-z0-9]+)?$
Example:

"together://ml_A1b2C3d4E5f6G7h8I9j0K"

compute_config
object

Compute layout to provision.

lora_enabled
boolean
default:true

Whether the resource hosts LoRA sessions or a single full-weight session

Example:

true

optimizer_config
object

Optimizer configuration for this resource.

Response

Model resource details

Allocated GPU resources that training sessions attach to

id
string
required

Unique identifier for the model resource

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Lifecycle status of the model resource

Available options:
MODEL_RESOURCES_STATUS_PENDING,
MODEL_RESOURCES_STATUS_CREATING,
MODEL_RESOURCES_STATUS_READY,
MODEL_RESOURCES_STATUS_ERROR,
MODEL_RESOURCES_STATUS_STOPPED,
MODEL_RESOURCES_STATUS_STOPPING
Example:

"MODEL_RESOURCES_STATUS_READY"

base_model
string
required

Base model the resource is provisioned for

Example:

"Qwen/Qwen3.5-4B"

compute_config
object
required

Compute layout provisioned for the resource.

lora_enabled
boolean
required

Whether the resource hosts LoRA sessions or a full-weight session

Example:

true

created_at
string<date-time>
required

Timestamp when the model resource was created

Example:

"2026-01-02T00:00:00Z"

updated_at
string<date-time>
required

Timestamp when the model resource was last updated

Example:

"2026-01-02T00:00:05Z"

optimizer_config
object
required

Optimizer configuration for this resource.

created_by
string
required

ID of the user who created the model resource

Example:

"user_123"

error
object

Structured detail for the model resource's current error. Set when the resource is in an error state.

base_weights_ref
string

Model-registry model whose weights the resource trains in place of the base model's own, pinned to the revision resolved when the resource was created. Absent when the resource trains the base model's own weights.

Example:

"together://ml_A1b2C3d4E5f6G7h8I9j0K@rv_A1b2C3d4E5f6G7h8I9j0K"