How to List Models

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

Each entry is one model + run type combination, so a model that supports both text-to-image and image-to-image appears twice.

Endpoint

GET https://api.get3w.com/v1/models/list

Query Parameters

Parameter	Required	Description
type	No	Only return entries of this run type, e.g. text-to-image. See Model Types

Request

cURL

curl "https://api.get3w.com/v1/models/list" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://api.get3w.com/v1/models/list",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"type": "text-to-video"},  # optional
    timeout=(10, 60),
)
response.raise_for_status()
models = response.json()["data"]

print(f"Total: {len(models)}")
for m in models[:5]:
    print(f"- {m['model_id']}: ${m['base_price']} / {m['billing_unit']}")

Response

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "model_id": "google/nano-banana-2.1/text-to-image",
      "name": "Nano Banana 2.1",
      "provider_id": "google",
      "description": "...",
      "type": "text-to-image",
      "base_price": 0.0286,
      "currency": "USD",
      "billing_unit": "image",
      "api_schema": {
        "api_schemas": [
          {
            "type": "model_run",
            "method": "POST",
            "server": "https://api.get3w.com",
            "api_path": "/v1/google/nano-banana-2.1/text-to-image",
            "request_schema": {
              "type": "object",
              "properties": {
                "prompt": {
                  "type": "string",
                  "description": "The positive prompt for the generation."
                },
                "aspect_ratio": {
                  "type": "string",
                  "enum": ["1:1", "16:9", "9:16"],
                  "default": "16:9"
                },
                "resolution": {
                  "type": "string",
                  "enum": ["1k", "2k", "4k"],
                  "default": "1k"
                }
              },
              "x-order-properties": ["prompt", "aspect_ratio", "resolution"],
              "required": ["prompt"]
            }
          }
        ]
      }
    }
  ]
}

Response Fields

Field	Type	Description
code	integer	200 on success
message	string	Status message
data	array	Array of model objects

Model Object

Field	Type	Description
model_id	string	Full slug {provider_id}/{model_id}/{run_type}, same as the submit path
name	string	Display name
provider_id	string	Provider, e.g. google, kling
description	string	Model introduction (pricing is in base_price, not here)
type	string	Run type, see Model Types
base_price	number|null	Starting price in USD per billing_unit; null if not priced
currency	string	Always USD
billing_unit	string|null	Billing unit, e.g. image, second, request, 1M tokens
api_schema	object	How to call the model

base_price is the lowest price for the model. The actual charge depends on parameters such as resolution or duration. See How Pricing Works.

api_schema Object

Field	Type	Description
api_schemas	array	Array of endpoint schemas
api_schemas[].type	string	Always model_run
api_schemas[].method	string	HTTP method
api_schemas[].server	string	API host
api_schemas[].api_path	string	Endpoint path. For chat models this is the native protocol path, see Chat API
api_schemas[].request_schema	object	JSON Schema of the request body

request_schema.x-order-properties lists parameters in their recommended display order.

Model Types

Type	Description
text-to-image	Generate images from text
image-to-image	Edit or transform images
text-to-video	Generate videos from text
first-to-video	Animate a first frame
first-last-to-video	Generate a video between two frames
reference-to-video	Generate a video from reference images
edit-to-video	Edit an existing video
extend-to-video	Extend an existing video
digital-human	Create a talking avatar
text-to-3d	Generate 3D models from text
image-to-3d	Generate 3D models from images
text-to-panorama	Generate panoramas from text
image-to-panorama	Generate panoramas from images
text-to-speech	Generate speech
speech-to-text	Transcribe audio
text-to-music	Generate music

Next Steps

• How to Submit Task — Call a model using its api_path
• What are Models
• How Pricing Works