List Models

Discover which models are available and what they cost. This endpoint is public, so you can call it before adding a key.

GET /v1/models#

List available models. Public endpoint; no authentication required.

Auth: Public

Parameter	Type	Required	Description
type	string	No	Filter by type: image, video, or audio. Returns all types when omitted.

Response

{
  "models": [
    {
      "id": "gemini-3.1-flash-image-preview",
      "name": "Nano Banana 2 🍌🍌",
      "type": "image",
      "credits": { "0.5K": 27, "1K": 35, "2K": 53, "4K": 105 }
    },
    {
      "id": "fal-ai/bytedance/seedance/v2",
      "name": "Seedance 2.0",
      "type": "video",
      "credits": {
        "480p": { "sound_on": 35, "sound_off": 35 },
        "720p": { "sound_on": 75, "sound_off": 75 }
      }
    }
  ]
}

Image models price by size bucket (credits per image). Video models price by resolution and sound (credits per generation).

List models#

JavaScript SDK

npm install picx-ai

import { PicX } from "picx-ai";

const picx = new PicX(); // no key required for this call

const { models } = await picx.models.list();
console.log(`${models.length} models available`);

const videoModels = await picx.models.list({ type: "video" });
for (const model of videoModels.models) {
  console.log(model.id, model.name, model.credits);
}

Python SDK

pip install picx-ai

from picx import PicX

picx = PicX()  # no key required for this call

all_models = picx.models.list()
print(f"{len(all_models)} models available")

video_models = picx.models.list(type="video")
for model in video_models:
    print(model.id, model.name, model.credits)

curl

# All models
curl https://api.picxstudio.com/v1/models

# Only image models
curl "https://api.picxstudio.com/v1/models?type=image"

# Only video models
curl "https://api.picxstudio.com/v1/models?type=video"

The credits field structure varies by model type. Image models return a flat object keyed by size ({"1K": 35, "2K": 53}). Video models return a nested object keyed by resolution and sound ({"720p": {"sound_on": 75, "sound_off": 75}}).

FAQ#

Do I need an API key to list models?#

No — GET /v1/models is public. Call it before you have a key to see what's available and what it costs.

How do I see only image models, or only video models?#

Pass type=image or type=video as a query parameter. Omit type to get every model across all types.

How is pricing structured for image vs. video models?#

Image models return a flat object keyed by size, e.g. {"1K": 35, "2K": 53} credits. Video models return a nested object keyed by resolution and sound, e.g. {"720p": {"sound_on": 75, "sound_off": 75}} credits.

What's the default image model if I don't specify one?#

gemini-3.1-flash-image-preview ("Nano Banana 2") — see Generate Image for the generation endpoint that uses it by default.