Lunos

Documentation

Models API Endpoint

The /public/models endpoint provides a list of all available AI models for chat completions and other generative tasks. Use this endpoint to discover model IDs, capabilities, pricing, and other metadata before making requests to the Lunos API.

Endpoint

GET /public/models

Authentication

No authentication is required to access this endpoint.

Response

The response is a JSON array of model objects. Each object contains details about a model, including its ID, name, provider, capabilities, pricing, and status.

1[
2  {
3    "id": "openai/gpt-4o",
4    "name": "GPT-4o",
5    "parameters": {
6      "context": 128000,
7      "max_output_tokens": 4096,
8      "size": "4B"
9    },
10    "provider": "openai",
11    "pricePerMillionTokens": {
12      "input": 5.0,
13      "output": 15.0
14    },
15    "capabilities": ["text-generation", "chat", "vision"],
16    "status": "available"
17  }
18]

Model Object Fields

FieldTypeDescription
idstringUnique model identifier (use this in API requests).
namestringHuman-readable model name.
parameters.contextnumberMaximum context window (tokens).
parameters.max_output_tokensnumberMaximum output tokens per request.
parameters.sizestringModel size (e.g., "4B").
providerstringModel provider (e.g., "openai").
pricePerMillionTokens.inputnumberCost per 1M input tokens (USD).
pricePerMillionTokens.outputnumberCost per 1M output tokens (USD).
capabilitiesstring[]Array of supported features (e.g., text-generation, chat, vision).
statusstringModel availability status (e.g., available).

Example Request

curl -X GET https://api.lunos.tech/public/models

Example Response

1[
2  {
3    "id": "openai/gpt-4o",
4    "name": "GPT-4o",
5    "parameters": {
6      "context": 128000,
7      "max_output_tokens": 4096,
8      "size": "4B"
9    },
10    "provider": "openai",
11    "pricePerMillionTokens": {
12      "input": 5.0,
13      "output": 15.0
14    },
15    "capabilities": ["text-generation", "chat", "vision"],
16    "status": "available"
17  },
18  {
19    "id": "openai/text-embedding-3-small",
20    "name": "Text Embedding 3 Small",
21    "parameters": {
22      "context": 8192,
23      "max_output_tokens": 2000,
24      "size": "1B"
25    },
26    "provider": "openai",
27    "pricePerMillionTokens": {
28      "input": 0.1,
29      "output": 0.3
30    },
31    "capabilities": ["embedding"],
32    "status": "available"
33  }
34]

Usage Tips

  • Use the id field as the model parameter in your API requests.
  • Check the capabilities array to ensure the model supports your use case (e.g., chat, vision, embedding).
  • Review the status field to confirm the model is available before using it in production.
  • Compare pricePerMillionTokens to optimize for cost based on your expected usage.
  • Reference parameters for model-specific limits like context window and max output tokens.