Models API
List models visible to an API Key and the endpoint types each model supports
The Models API lists models visible to the current API Key and the endpoint types each model supports. Before calling other capabilities, use this endpoint to confirm available models.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/models | List models visible to the current token |
Model selection: The model field in other request bodies must be a data[].id returned by this endpoint. supported_endpoint_types indicates which capabilities the model can use.
GET /v1/models
List models visible to the current token.
Auth: Bearer Token
Request: No request body
Request example (curl)
curl https://www.guid.ai/v1/models \
-H "Authorization: Bearer sk-xxx"
Response body
HTTP 200
{
"success": true,
"object": "list",
"data": [
{
"id": "gpt-4o",
"object": "model",
"created": 1626777600,
"owned_by": "openai",
"supported_endpoint_types": [
"openai",
"openai-response",
"image-generation"
]
},
{
"id": "agnes-video-v2.0",
"object": "model",
"created": 1626777600,
"owned_by": "agnes-ai",
"supported_endpoint_types": [
"openai-video"
]
}
]
}
Response fields
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the call succeeded |
object | string | Always list |
data | array | Model list |
data[].id | string | Model ID; use this value as model in other endpoints |
data[].object | string | Always model |
data[].created | number | Unix timestamp (seconds) |
data[].owned_by | string | Model ownership identifier |
data[].supported_endpoint_types | string | Supported endpoint types |
data[].tags | string | Model tags (if any) |
supported_endpoint_types values
| Value | Description | Related docs |
|---|---|---|
openai | Chat / Completions | Text API |
openai-response | Responses chat | Text API |
image-generation | Image generation / editing | Images API |
openai-video | Video generation | Videos API |
Failure response
HTTP 200 (business failure)
{
"success": false,
"message": "get user group failed"
}
| Field | Type | Description |
|---|---|---|
success | boolean | Always false |
message | string | Failure reason |
See Gateway extended errors for the error format.