List Models
List available models. Public — no authentication required. Filter by type.
All docs
Getting Started
Code Examples
On this page
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": 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
creditsfield 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.
