Base Models

Get recommended base models

Changed on

Layer's curated recommendations, filtered to the models this workspace may run. Use this to pick a model when the caller named a modality or an intent but not a specific base_model_id: take entry [0] of the matching bucket, falling through to later entries if it is unavailable. Prefer preferred_by_use_case over featured_by_modality when the intent is known, since it is finer-grained.

The curation changes as models ship and are retired, so clients should re-read this periodically rather than hard-coding a model id.

get/v2/workspaces/{workspace_id}/base-models/defaults

Request

  • Base URL: https://api.app.layer.ai/api
  • URL: https://api.app.layer.ai/api/v2/workspaces/{workspace_id}/base-models/defaults
  • 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: generation:read)

Path parameters

workspace_idstring uuid required

Id of the workspace that owns the resource.

Response

Successful Response

featured_by_modalityobject required

Recommended base models per output modality, best first. [0] is the default for a request that names only a modality.

preferred_by_use_caseobject required

Recommended base models per use case, best first. Finer-grained than modality — prefer this when the caller's intent is known.

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

  • 961b4221b5d9Revision changes
    • warning

      added the new create_skybox enum value to the / response property for the response status

    • warning

      added the new voice_change enum value to the / response property for the response status