How to List Models
Get a list of all available models on WaveSpeedAI, including their parameters and pricing.
Endpoint
GET https://api.wavespeed.ai/api/v3/modelsRequest
curl --location --request GET 'https://api.wavespeed.ai/api/v3/models' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}'Response
{
"code": 200,
"message": "success",
"data": [
{
"model_id": "wavespeed-ai/hunyuan-video/t2v",
"name": "wavespeed-ai/hunyuan-video/t2v",
"base_price": 0.4,
"description": "The advanced text-to-video model for generating high-definition videos",
"type": "text-to-video",
"api_schema": {
"api_schemas": [
{
"type": "model_run",
"method": "POST",
"server": "https://api.wavespeed.ai",
"api_path": "/api/v3/wavespeed-ai/hunyuan-video/t2v",
"request_schema": {
"properties": {
"prompt": {
"description": "The positive prompt for the generation.",
"type": "string"
},
"size": {
"default": "1280*720",
"enum": ["1280*720", "720*1280"],
"type": "string"
},
"seed": {
"default": -1,
"type": "integer"
},
"num_inference_steps": {
"default": 30,
"minimum": 2,
"maximum": 30,
"type": "integer"
}
},
"required": ["prompt"]
}
}
]
}
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
code | integer | HTTP status code (200 for success) |
message | string | Status message |
data | array | Array of model objects |
Model Object
| Field | Type | Description |
|---|---|---|
model_id | string | Unique model identifier |
name | string | Model name |
base_price | float | Base price in USD |
description | string | Model description |
type | string | Model type (e.g., text-to-video) |
api_schema | object | API schema with parameters |
api_schema Object
| Field | Type | Description |
|---|---|---|
api_schemas | array | Array of API endpoint schemas |
api_schemas[].type | string | Schema type (e.g., model_run) |
api_schemas[].method | string | HTTP method |
api_schemas[].api_path | string | API endpoint path |
api_schemas[].request_schema | object | Request parameters schema |
Python Example
import os
import requests
api_key = os.environ.get("WAVESPEED_API_KEY")
def list_models():
response = requests.get(
"https://api.wavespeed.ai/api/v3/models",
headers={"Authorization": f"Bearer {api_key}"}
)
return response.json()["data"]
# List all models
models = list_models()
print(f"Total models: {len(models)}")
# Filter by type
t2v_models = [m for m in models if m.get("type") == "text-to-video"]
for model in t2v_models[:5]:
print(f"- {model['name']}: ${model['base_price']}")Model Types
| Type | Description |
|---|---|
text-to-image | Generate images from text |
image-to-image | Transform images |
text-to-video | Generate videos from text |
image-to-video | Animate images |
video-to-video | Transform videos |
text-to-audio | Generate audio |