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_KEYsk-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: Alwayslistdata: Array of available model entriesid: Model identifier - pass this asmodelin inference requestsobject: Alwaysmodelcreated: Creation Unix timestamp in secondsowned_by: Provider or organization that owns the model
Video API Usage Examples and Best Practices
This document provides complete usage examples and a best practices guide for the ZipFlow video generation API.
Token Usage Query
Retrieve the current Bearer token's quota usage: total granted, used, available, unlimited flag, model limits and expiration time.