List Models
List every model available to your account.
Returns the live catalogue: ids, pricing, limits and what each model accepts.
Video models also carry inputs: which of first frame, last frame, reference images, clip and audio the model takes, the audio mode (driving or reference) and combinations, the valid input combinations in plain sentences. Build video requests from it; the same rules are listed under Input combinations on POST /v1/videos/generations.
Kind-specific blocks: speech on speech models (voices, tags, streaming), video_edit on POST /v1/videos/edits models, realtime on live-call models, plus the flags silent (the video never has sound) and bills_input_video_seconds (an input video_url clip is billed per second too).
curl --request GET \ --url https://api.spicyapi.com/v1/models \ --header 'Authorization: Bearer $SPICYAPI_KEY'
{
"data": [
{
"id": "spicy-motion-3",
"kind": "video",
"label": "Spicy Motion 3",
"featured": false,
"requires_image": false,
"accepts_image": true,
"accepts_reference": true,
"pricing": { "unit": "second", "usd_by_resolution": { "480P": 0.1, "720P": 0.2, "1080P": 0.4 } },
"limits": { "resolutions": ["480P", "720P", "1080P"], "minDuration": 2, "maxDuration": 30, "aspectRatios": ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"], "maxPromptChars": 20000 },
"inputs": {
"first_frame": "optional",
"last_frame": true,
"reference_images": 10,
"reference_video": true,
"continuation_clip": false,
"audio": { "mode": "reference", "max_clips": 5, "max_total_seconds": 15, "with_first_frame": false },
"aspect_ratio": true,
"smart_duration": true,
"combinations": [
"Text prompt only, with aspect_ratio; dialogue written in the prompt is spoken natively",
"First frame (image_url), optionally a last frame (last_frame_url); no references or audio in the same request",
"Reference images (up to 10, or a character) plus a text prompt: same person, framing chosen by the model",
"Reference images, a reference video (video_url, 15s max) and reference audio (up to 5 clips, 15s total) in any mix, with a text prompt; audio guides voice, tone and beat while the words come from the prompt"
]
},
"bills_input_video_seconds": true,
"actions": true
},
{
"id": "spicy-image-1",
"kind": "image",
"label": "Spicy Image 1",
"featured": false,
"requires_image": false,
"accepts_image": false,
"accepts_reference": false,
"pricing": { "unit": "image", "usd": 0.06 },
"limits": { "sizes": ["1024*1024", "832*1216", "1216*832", "1280*1280", "1440*1440", "1024*1536", "1536*1024", "1080*1920", "1920*1080", "1152*2048", "2048*1152"], "maxOutputs": 6 }
},
{
"id": "spicy-voice-1-custom",
"kind": "speech",
"label": "Spicy Voice 1 Custom",
"featured": false,
"requires_image": false,
"accepts_image": false,
"accepts_reference": false,
"pricing": { "unit": "10K characters", "usd_per_10k_chars": 0.3 },
"limits": { "maxPromptChars": 600 },
"speech": {
"voices": [],
"custom_voices": true,
"instructions": false,
"languages": ["Auto", "English", "Chinese", "German", "Italian", "Portuguese", "Spanish", "Japanese", "Korean", "French", "Russian"],
"output_format": "wav",
"streaming": false,
"voice_creation_usd": { "designed": 0.4, "cloned": 0.02 }
}
}
]
}Response
200 · application/jsonSuccessful Response
The models your key can call.
Every model available to you.
Only on the locked shape: explicit_media.
Only on the locked shape: why, and how to get the full library.
Was this page helpful?