v0.3.0

OpenAPI 3.1.0

List available models

Felo API Support

MIT

Server

https://openapi.felo.ai

Client Libraries

Shell Curl

List available models

By default, returns all model categories, including chat, image_generation, video_generation, and decisions. Models must be enabled, listed, not deleted, and have current pricing (zero is valid). The optional provider filter retains the existing pricing and mapping conditions. Results are ordered by administrator sort_order ascending, then model name and ID. Newly synchronized models are hidden until listed by an administrator. Hiding only affects discovery lists; disabling also rejects new calls. Model detail lookup is unchanged. Read model_kind before choosing a calling endpoint: video_generation uses /api/v1/videos/generations; decisions uses /api/v1/decisions. Dedicated discovery lists are available at /api/v1/videos/models and /api/v1/decisions/models. Set exclude_video_and_decisions=true to exclude video and decision models after provider category overrides; image models remain eligible.

Query Parameters

provider
Type: string
min length:
1

Optional provider filter, for example ephone or openrouter.
exclude_video_and_decisions
Type: boolean

When true, excludes effective model_kind values video_generation and decisions. Image models remain eligible. Can be combined with provider. Omit or set false to include all categories.

Responses

200
Type: object · ModelList

Available models
data
Type: array object[] · Model[]
required
created
Type: integer Format: int64
required

Model catalog creation timestamp in Unix seconds.

id
Type: string
required

Felo model id.

object
const:
model
required
owned_by
Type: string
required
model_kind
Type: string

Effective model capability category after enabled provider mapping overrides: chat, image_generation, video_generation, or decisions. Use the calling endpoint matching this category.

propertyName
Type: anything
object
const:
list
required
propertyName
Type: anything
application/json
401
Type: object · OpenAIErrorResponse

Invalid or missing Felo API key

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
Type: object
required
message
Type: string
required
code
Type: string | null
param
Type: string | null
type
Type: string

OpenAI-compatible error type when supplied.

propertyName
Type: anything
propertyName
Type: anything
application/json
422
Type: object

Invalid query parameter, such as an empty provider or an invalid boolean value
detail
Type: array object[]
required
propertyName
Type: anything
application/json
503
Type: object · OpenAIErrorResponse

Model catalog is temporarily unavailable

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
Type: object
required
message
Type: string
required
code
Type: string | null
param
Type: string | null
type
Type: string

OpenAI-compatible error type when supplied.

propertyName
Type: anything
propertyName
Type: anything
application/json

get/api/v1/models

curl "https://openapi.felo.ai/api/v1/models?exclude_video_and_decisions=true&provider=openrouter" \
  -H "Authorization: Bearer ${FELO_API_KEY}"

Show Schema

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "model",
      "created": 1,
      "owned_by": "string",
      "model_kind": "string",
      "additionalProperty": "anything"
    }
  ],
  "additionalProperty": "anything"
}

Available models

List available models

AuthenticationRequired

List available models