Skip to content
PensievePensievePensieve

List a model's versions

GET
/v1/models/{model}/versions
curl --request GET \
  --url 'https://api.pensievelabs.co/v1/models/grade-audit/versions?limit=20' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
model
required
string

The model’s slug, such as grade-audit, or its mdl_ id.

Example 

grade-audit

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 20 >= 1 <= 100
cursor
string

The next_cursor of the page before.

Responses

Section titled “Responses”

200

Section titled “200”

Versions, newest first.

Media typeapplication/json
object
object
required
Allowed value: list
has_more
required
boolean
next_cursor
required
string | null
data
required
Array<object>
object
id
required
string
object
required
Allowed value: version
model
required
string
version
required
string
status
required
string
Allowed values: candidate live standby retired
released_at
required
string | null format: date-time
note
required
string
test_score
required
number | null
frontier_score
required

The best frontier model’s score when this version was tested.

number | null
expert_hours
required

Expert time this version took.

number
size
required
string
weights_available
required
boolean
recipe
required
One of:

The post-training a version is made of. Each kept experiment changes one thing in it; the next experiment’s A is this recipe.

object
base_model
required

The open model it starts from.

string
steps
required

The training steps, in order.

Array<object>
object
method
required

A post-training method’s slug, such as fine-tuning. See List methods for what your workspace has.

string
<= 64 characters /^[a-z0-9]+(-[a-z0-9]+)*$/
description
required
string
data
required

The data sources it learns from, and how each is used.

Array<object>
object
source
required

A source id.

string
use
required

How the recipe uses it.

string
experiments
required

The kept experiments that shaped this recipe.

Array<string>

Example 

{
  "object": "list",
  "data": [
    {
      "id": "ver_grade_audit_v7",
      "object": "version",
      "version": "v7",
      "status": "candidate",
      "size": "8B parameters",
      "recipe": {
        "base_model": "Open 8B base",
        "steps": [
          {
            "method": "fine-tuning",
            "description": "Weight overturned grades 4×"
          }
        ],
        "data": [
          {
            "source": "src_reviewer_verdicts",
            "use": "Training examples; 5,000 held out as your test"
          }
        ]
      }
    }
  ]
}

default

Section titled “default”

Something went wrong; error.type says what.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request authentication permission not_found conflict rate_limit not_available server
message
required
string
param

The request field the error is about.

string | null
request_id
required
string

Example 

{
  "error": {
    "type": "invalid_request"
  }
}