PicX Studio

List Models

List available models. Public — no authentication required. Filter by type.

View as Markdown

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

ParameterTypeRequiredDescription
typestringNoFilter 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": 30, "1K": 35, "2K": 53, "4K": 105 }
    },
    {
      "id": "bytedance/seedance/v2",
      "name": "Seedance 2.0",
      "type": "video",
      "credits": {
        "480p": { "sound_on": 45, "sound_off": 45 },
        "720p": { "sound_on": 100, "sound_off": 100 },
        "1080p": { "sound_on": 220, "sound_off": 220 },
        "4k": { "sound_on": 500, "sound_off": 500 }
      }
    }
  ]
}

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

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.

Build with PicX

One API key and one credit balance across the REST API, MCP server, CLI and SDKs.