List Models API

Get a list of all available models on WaveSpeedAI, including their parameters and pricing.

API Information

Item	Description
API Path	`/api/v3/models`
HTTP Method	`GET`
Authentication	Bearer Token via `Authorization` header

Request


curl -X GET "https://api.wavespeed.ai/api/v3/models" \
-H "Authorization: Bearer YOUR_API_KEY"

Parameters

Headers

Parameter	Type	Required	Description
Authorization	string	Yes	Access Key in format: `Bearer {access_key}`

Response

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	Example
model_id	string	Unique model identifier	`"wavespeed-ai/hunyuan-video/t2v"`
name	string	Model name	`"wavespeed-ai/hunyuan-video/t2v"`
base_price	float	Base price in USD	`0.4`
description	string	Model description	`"The advanced text-to-video model..."`
type	string	Model type	`"text-to-video"`
api_schema	object	API schema with parameters	See below

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 with properties, required fields, and defaults

Response Example

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "model_id": "wavespeed-ai/hunyuan-video/t2v",
      "name": "wavespeed-ai/hunyuan-video/t2v",
      "base_price": 0.4,
      "formula": "",
      "description": "The advanced text-to-video model for generating high-definition videos with realistic motions",
      "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": {
                "num_inference_steps": {
                  "default": 30,
                  "description": "The number of inference steps to perform.",
                  "maximum": 30,
                  "minimum": 2,
                  "type": "integer"
                },
                "prompt": {
                  "description": "The positive prompt for the generation.",
                  "type": "string"
                },
                "seed": {
                  "default": -1,
                  "description": "The random seed to use for the generation. -1 means a random seed will be used.",
                  "type": "integer"
                },
                "size": {
                  "default": "1280*720",
                  "description": "The size of the generated media in pixels (width*height).",
                  "enum": [
                    "1280*720",
                    "720*1280"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "prompt"
              ],
              "type": "object",
              "x-order-properties": [
                "prompt",
                "size",
                "seed",
                "num_inference_steps"
              ]
            }
          }
        ]
      }
    }
  ]
}

Overview