Models - Together AI docs

Register, upload, and inspect the models and adapters you deploy for dedicated model inference deployments with the 2.0 API. Bringing your own weights is a two-step flow:

create registers a model record (metadata only), then
upload or remote-uploads create adds the weight files.

See Custom models for the end-to-end workflow.

These commands target the 2.0 API. For the 1.0 model commands, see models. Commands run within a Together project.

Create

Register a new model record. This creates metadata only; it does not upload any files. Upload the weights afterward with upload or remote-uploads create.

Shell

tg beta models create my-custom-glm \
  --base-model zai-org/GLM-5.2

Alias: tg beta models -c.

Parameters

Flag	Description
`NAME`	(required) The inference-addressable name for the model.
`--type [model \| adapter]`	Whether the record holds full weights (`model`) or a LoRA adapter (`adapter`). Set once at create time. File operations derive the type from the record. Default: `model`.
`--base-model [string]`	(required) A supported base model ID (`ml_...`) this model derives from. Run `tg beta models public --json` to find it.

Upload

Upload weight files from your local machine to an existing model or adapter record.

Shell

tg beta models upload ml_abc123 ./my-model-weights

Parameters

Flag	Description
`MODEL-ID`	(required) The existing model or adapter ID to upload files to.
`LOCAL-PATH`	(required) The local file or directory to upload.

List

List the models in the current project.

Shell

tg beta models list

Alias: tg beta models ls.

Parameters

Flag	Description
`--limit [number]`	Maximum number of models to return.
`--after [string]`	Pagination cursor to start from.

Retrieve

Get a single model by ID.

Shell

tg beta models retrieve ml_abc123

Alias: tg beta models get.

Update

Update a model record. Only the fields you pass are changed.

Shell

tg beta models update ml_abc123 \
  --name my-renamed-model \
  --description "Fine-tuned GLM for support triage"

Parameters

Flag	Description
`ID`	(required) The model ID to update.
`--name [string]`	New inference-addressable name.
`--description [string]`	New description.

Delete

Delete a model record. This removes the metadata; it does not delete uploaded files.

Shell

tg beta models delete ml_abc123

Alias: tg beta models -d.

Configs

List the deployable configs for a model. Pass a config ID to tg beta endpoints deploy --config to deploy that specific configuration.

Shell

tg beta models configs ml_abc123

Parameters

Flag	Description
`MODEL`	(required) The model ID to list configs for.
`--limit [number]`	Maximum number of configs to return.
`--after [string]`	Pagination cursor to start from.

List files

List the files in a model or adapter.

Shell

tg beta models ls-files ml_abc123

Parameters

Flag	Description
`ID`	(required) The model or adapter ID.
`--revision [string]`	Revision ID to filter files for.

List revisions

List the revisions of a model.

Shell

tg beta models ls-revisions ml_abc123

Parameters

Flag	Description
`ID`	(required) The model ID.

Download

Download the weight files of a model or adapter to a local directory.

Shell

tg beta models download ml_abc123 ./local-dir

Parameters

Flag	Description
`MODEL-ID`	(required) The model or adapter ID (a `project/name` path or object ID).
`LOCAL-PATH`	(required) The local directory to write files into.
`--revision [string]`	Pin the download to a specific revision. Defaults to the latest.
`--files [string]`	Restrict to specific file paths. Repeatable, and commas are allowed.
`--format [hf]`	Output layout. Use `hf` for a Hugging Face snapshot layout.

List public models

List the publicly visible models across all projects. Use this to find a base model ID for create or a model name for tg beta endpoints deploy.

Shell

tg beta models public \
  --product dedicated \
  --modality text

Add --json to see each model’s full record, including its id (which subsequent operations require) and its deploymentProfiles array. A model can expose more than one profile, each pairing a certified config with a hardware and parallelism choice, so read the id, config, gpuType, and gpuCount of the profile you want before deploying. See Choose a hardware config.

Parameters

Flag	Description
`SEARCH`	Search by ID, name, or description.
`--limit [number]`	Maximum number of models to return.
`--after [string]`	Pagination cursor to start from.
`--modality [text \| image \| audio \| video]`	Filter by input modality.
`--product [serverless \| dedicated \| fine-tuning]`	Filter by product surface.

List org models

List the internal-visibility models in your organization.

Shell

tg beta models org

Parameters

Flag	Description
`--limit [number]`	Maximum number of models to return.
`--after [string]`	Pagination cursor to start from.

Remote uploads

Import model weights server-side from a Hugging Face repo or a presigned S3/GCS URL, without downloading them locally first. Create a remote upload job against an existing model record, then poll it until it succeeds.

Remote uploads create

Start a remote upload job.

Shell

tg beta models remote-uploads create ml_abc123 \
  --from https://huggingface.co/zai-org/GLM-5.2

For gated or private Hugging Face repos, pass a source credential with --token. For S3 or GCS, pass a presigned archive URL as --from (no token needed).

Parameters

Flag	Description
`MODEL-ID`	(required) The existing model or adapter ID to upload files to.
`--from [string]`	(required) The remote source URL (a Hugging Face repo or a presigned S3/GCS URL).
`--token [string]`	Source credential for gated or private Hugging Face repos.

Remote uploads retrieve

Get a remote upload job by ID. Poll this until status is REMOTE_UPLOAD_STATUS_SUCCEEDED.

Shell

tg beta models remote-uploads retrieve job_abc123

Parameters

Flag	Description
`ID`	(required) The remote upload job ID.

Remote uploads list

List remote upload jobs.

Shell

tg beta models remote-uploads list

Parameters

Flag	Description
`--limit [number]`	Maximum number of jobs to return.
`--after [string]`	Pagination cursor to start from.

Global options

Every command also accepts the global parameters, including --json for machine-readable output and --project to override the target project.

Resource IDs

Prefix	Resource
`ml_`	Model or adapter record.
`cr_`	Config revision (a deployable configuration of a model).
`job_`	Remote upload job.

​Create

​Parameters

​Upload

​Parameters

​List

​Parameters

​Retrieve

​Update

​Parameters

​Delete

​Configs

​Parameters

​List files

​Parameters

​List revisions

​Parameters

​Download

​Parameters

​List public models

​Parameters

​List org models

​Parameters

​Remote uploads

​Remote uploads create

​Parameters

​Remote uploads retrieve

​Parameters

​Remote uploads list

​Parameters

​Global options

​Resource IDs

Create

Parameters

Upload

Parameters

List

Parameters

Retrieve

Update

Parameters

Delete

Configs

Parameters

List files

Parameters

List revisions

Parameters

Download

Parameters

List public models

Parameters

List org models

Parameters

Remote uploads

Remote uploads create

Parameters

Remote uploads retrieve

Parameters

Remote uploads list

Parameters

Global options

Resource IDs