Models

List models

Return supported prompt model IDs and defaults without consuming inference or credit. Pass provider and id as inference.provider and inference.model. The complete list is sorted by provider then model ID. Optional provider filtering uses gemini for Google models. default is always the API-wide default; default_for_provider marks each provider default. This catalog does not report prices, live provider health, credentials, or capacity. Managed PDF/image scanning accepts only the default OpenAI model; other catalogued OpenAI scan models require your own key.

GET

models

List supported prompt models and defaults

curl --request GET \
  --url https://revise.io/api/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://revise.io/api/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://revise.io/api/v1/models",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://revise.io/api/v1/models"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://revise.io/api/v1/models")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "default": {
    "provider": "openai",
    "model": "gpt-6-luna"
  },
  "data": [
    {
      "id": "gpt-6-luna",
      "provider": "openai",
      "name": "GPT-6 Luna",
      "default_for_provider": true
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

See model selection and provider keys for integration guidance.

TypeScript

import { ReviseClient } from "@reviseio/api";

const revise = new ReviseClient({ apiKey: process.env.REVISE_API_KEY! });
const result = await revise.models.list();

Authorizations

Authorization

string

header

required

Revise API key from https://revise.io/console/api-keys. Send Authorization: Bearer .

Query Parameters

provider

enum<string>

Optional exact public provider.

Available options:

openai,

anthropic,

xai,

gemini

Response

Model catalog

data

object[]

required

Show child attributes

default

object

required

Show child attributes

List supported prompt models and defaults

curl --request GET \
  --url https://revise.io/api/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://revise.io/api/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://revise.io/api/v1/models",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://revise.io/api/v1/models"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://revise.io/api/v1/models")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "default": {
    "provider": "openai",
    "model": "gpt-6-luna"
  },
  "data": [
    {
      "id": "gpt-6-luna",
      "provider": "openai",
      "name": "GPT-6 Luna",
      "default_for_provider": true
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Getting started

Guides

REST reference

List models

TypeScript

Authorizations

Query Parameters

Response

​TypeScript

Authorizations

Query Parameters

Response

TypeScript