List Models

Retrieve available models.

GET /v1/models

Returns the models currently available to the authenticated user or token.

This is not a global upstream catalog. The result is filtered by the current auth context, enabled groups, token model restrictions, and deployment-side billing/model availability settings.

Authentication#

Use a Bearer token in the Authorization header.

Parameters#

No request body or query parameters are required.

Request#

curl https://ai.pofano.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Response#

{
  "success": true,
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1686935002,
      "owned_by": "openai"
    },
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1729123200,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.0-flash",
      "object": "model",
      "created": 1735689600,
      "owned_by": "google"
    }
  ]
}

Notes#

• The returned list depends on the current user or token, not on every model known to the deployment.
• A token with model restrictions may see a smaller list than the owning user.
• Some deployments hide models that do not have usable billing configuration.

Retrieve A Single Model#

GET /v1/models/{model}

Returns metadata for a single OpenAI-compatible model when it exists.

curl https://ai.pofano.com/v1/models/gpt-4o \
  -H "Authorization: Bearer YOUR_API_KEY"

When the model is missing, the current implementation may still return HTTP 200 with an error object in the response body:

{
  "error": {
    "message": "The model 'missing-model' does not exist",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

For Gemini-native model listing, use GET /v1beta/models instead of GET /v1/models?key=....