Training

Estimate training price

Changed on

Estimate the Creative Units cost of training a LoRA for a reference set.

post/v1/workspaces/{workspace_id}/training-runs/estimate

Request

  • Base URL: https://api.app.layer.ai/api
  • URL: https://api.app.layer.ai/api/v1/workspaces/{workspace_id}/training-runs/estimate
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.app.layer.ai/authorize, token URL https://auth.app.layer.ai/oauth/token)
    • OAuth 2 (client credentials, token URL https://api.app.layer.ai/api/oauth/token, scopes: reference_sets:read)

Path parameters

workspace_idstring uuid required

Id of the workspace that owns the resource.

Headers

Idempotency-Keystring

Opaque key making a retry of this request return the first result. A 2xx response is replayed for 24 hours with Idempotent-Replayed: true. A 4xx releases the key. A 5xx, or a request still running, holds the key for 120 seconds, during which a retry gets 409; after that a retry executes again. The key covers the method, path, query, and byte-identical body it was first used with; reusing it for a different request is rejected with 422. Protection is best effort: if the key store is unavailable, or a record is lost early, a retry can execute again even after an earlier 409. See the Idempotency section of the API description.

Request body

reference_set_idstring uuid required

The reference set to price training for.

base_model_idstring nullable

Base model to train. Omit to use the reference set's configured or workspace default model.

training_framework'fal' | 'ai-toolkit' nullable

Training framework override. Omit for the server default.

Response

Successful Response

estimated_price_creative_unitsnumber required

Estimated Creative Units to train this reference set.

base_model_idstring required

The base model the estimate was computed for.

workspace_balance_creative_unitsnumber required

Usable Creative Units balance (total minus reserved by in-progress work).

estimated_remaining_balance_creative_unitsnumber required

Usable balance after subtracting the estimated price. Can be negative.

has_sufficient_creative_unitsboolean required

Whether the workspace has enough available Creative Units to cover the estimate.

Changes

  • 326f3bcdabccRevision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 2d86d473cda6Revision changes
    • info

      the endpoint scheme security serviceAccount was added to the API

    • info

      the security scope reference_sets:read was removed from the endpoint's security scheme oauth2