list_models

GET /api/v2/models

Public: works without a key. With a key it counts toward your price-check limit.

• Auth: Optional. Works without a key; a key counts toward your price-check limit.
• Raw spec: https://app.diffusr.ai/api/v2/openapi.json

Query

Name	Type	Required	Description
kind	“video” | “image”	no

Example

cURL

curl "https://app.diffusr.ai/api/v2/models?kind=video" \
  -H "Authorization: Bearer $DIFFUSR_KEY"

TypeScript

import { Diffusr } from "diffusr";

const d = new Diffusr(); // reads DIFFUSR_KEY
const { models } = await d.listModels({ kind: "video" });
console.log(models.map((m) => m.id));

Python

from diffusr import Diffusr

d = Diffusr()  # reads DIFFUSR_KEY
data = d.list_models(kind="video")
print([m["id"] for m in data["models"]])

Response

200 ApiModelList

The models you can pass as `model`, with prices.

Name	Type	Required	Description
models	object[]	yes
models[].id	string	yes	Pass this as model.
models[].name	string	yes
models[].kind	“video” | “image”	yes
models[].aspect_ratios	string[]	yes
models[].resolutions	string[]	no
models[].duration_sec	object	no
models[].duration_sec.min	number	yes
models[].duration_sec.max	number	yes
models[].duration_sec.default	number	yes
models[].max_reference_images	number	yes
models[].takes_video	boolean	yes
models[].takes_audio	boolean	yes	Takes voice or sound clips in audio_urls.
models[].reference_labels	object	no
models[].reference_labels.image	string	no
models[].reference_labels.video	string	no
models[].reference_labels.audio	string	no
models[].cost	object | object | object | object	yes	The price as a simple number, at the API direct tariff.
models[].price	object	yes
models[].price.unit	“second” | “image”	yes
models[].price.credits	number	yes	Credits per second of video, or per image, at the settings in at.
models[].price.at	object	yes
models[].price.by_resolution	map of number	no	The same price at each resolution, when the model has several.
models[].price.tariff	“direct”	yes
models[].price.tariff_version	string	yes
models[].about	string	no
models[].caveat	string	no

Errors

Every error body is { error, code, request_id, ... }. All codes and what to do.

• 422: The request is not valid (VALIDATION_FAILED, INVALID_JSON, PREFLIGHT_FAILED, CALLBACK_URL_INVALID, REFERENCE_*). `issues` lists each problem. Nothing was charged.
• 429: Too many requests or jobs (RATE_LIMITED, CONCURRENCY_LIMIT, UPLOAD_QUOTA, …). Wait Retry-After seconds, then retry.
• 500: Our fault (INTERNAL_ERROR). Quote request_id to support.
• 503: Paused or busy (API_PAUSED, MODEL_PAUSED, PROVIDER_PAUSED, PROVIDER_BUSY, UNAVAILABLE). Wait Retry-After seconds, then retry.

Charges

Free. No credits are spent.