API Reference

List Models (Model)

List the models available to your API key through the OpenAI-compatible GET /v1/models endpoint.

What it does

Lists the models your API key can access, in the standard OpenAI GET /v1/models format. Use a returned id as the model value in inference requests.

๐Ÿ“ฎ Endpoint

GET /v1/models
  • Requires Authorization header
  • Returns the models available to the token used in the current request

๐Ÿ” Authentication

Include the following header for API key authentication:

Authorization: Bearer $ZIPFLOW_API_KEY
  • sk- prefix is accepted but optional; the server normalizes it
  • Missing or invalid Authorization header returns 401

๐Ÿ’ก Request Example

curl https://api.zipflow.xyz/v1/models \
  -H "Authorization: Bearer $ZIPFLOW_API_KEY"

โœ… Success Response Example

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4.1",
      "object": "model",
      "created": 1686935002,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4",
      "object": "model",
      "created": 1686935002,
      "owned_by": "anthropic"
    }
  ]
}

โ— Error Response Examples

  • Missing Authorization header:
{
  "error": {
    "message": "You did not provide an API key. Provide your API key in an Authorization header using Bearer auth.",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}
  • Invalid API key:
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

๐Ÿงพ Field Descriptions

  • object: Always list
  • data: Array of available model entries
    • id: Model identifier - pass this as model in inference requests
    • object: Always model
    • created: Creation Unix timestamp in seconds
    • owned_by: Provider or organization that owns the model

On this page