Kolbo.AIKolbo.AI Docs
Developer API

Models & Pricing

Discover available AI models and their credit costs.

Kolbo provides + AI models that are dynamically available. New models are added regularly and immediately accessible via the API.

List Models

GET /api/v1/models

Query Parameters

ParameterTypeDescription
typestringFilter by DB type name: text_to_img, image_editing, text_to_video, img_to_video, draw_to_video, video_to_video, elements, firstlastgenerations, lipsync-image, lipsync-video, music_gen, text_to_speech, text_to_sound, stt, text, 3d_text_to_model, 3d_image_to_model, 3d_multi_image_to_model, 3d_world. Legacy aliases also accepted: image, image_edit, video, video_from_image, video_from_video, music, speech, sound, chat, lipsync, three_d, first_last_frame, transcription.
providerstringFilter by provider (e.g., fal, kie, suno, elevenlabs)

Example

# All image generation models
curl "https://api.kolbo.ai/api/v1/models?type=text_to_img" \
  -H "X-API-Key: kolbo_live_..."

# All text-to-video models from a specific provider
curl "https://api.kolbo.ai/api/v1/models?type=text_to_video&provider=fal" \
  -H "X-API-Key: kolbo_live_..."

Response

{
  "success": true,
  "models": [
    {
      "identifier": "nano-banana-2",
      "name": "Nano Banana 2 1K",
      "provider": "fal",
      "types": ["text_to_img"],
      "credit": 8,
      "supported_aspect_ratios": ["1:1", "16:9", "9:16", "4:3", "3:4"],
      "supported_aspect_ratios_by_type": null,
      "default_aspect_ratio": "1:1",
      "supported_resolutions": ["1K", "2K", "4K"],
      "resolution_multipliers": { "1K": 1.0, "2K": 1.5, "4K": 2.0 },
      "supported_durations": null,
      "max_reference_images": 8,
      "max_visual_dna": 8,
      "supports_visual_dna": true,
      "supports_first_last_frame": false,
      "requires_prompt": true,
      "min_prompt_length": null,
      "max_prompt_length": 2000,
      "max_file_size": null,
      "recommended": true,
      "new_model": false,
      "avatar": "https://..."
    }
  ],
  "count": 42
}

Model Fields — full reference

The response is a flat object; fields not applicable to a model family are null / [] / 0. Read the constraint envelope before submitting a generation — out-of-envelope values are rejected with 400, not silently substituted.

Identity & cost

FieldDescription
identifierUse this exact value as the model parameter in generation requests.
creditBase credits per generation (chat/image/music/sound) or per second (video).
recommended / new_modelCurated badges.
summarySmart-Select strength summary (empty string = "named-only" — only use when the user explicitly requests by name).
model_typeSub-classification (e.g. for image-edit models: upscale, inpaint, face_swap, etc.).

Output constraints

FieldDescription
supported_aspect_ratiosValid aspect ratios. Empty array = the model has no aspect tiering.
supported_aspect_ratios_by_typePer-type override map (multimodal models). Prefer this over the flat array when set.
default_aspect_ratioWhat the API picks if aspect_ratio is omitted.
supported_resolutionsValid resolution labels (["1K","2K","3K","4K"] for images; ["720p","1080p","1440p","2160p"] for video).
resolution_multipliersPer-resolution cost multiplier on credit. e.g. 2K = 1.5×.
min_resolution / max_resolutionModel-specific lower/upper bound (when supported_resolutions isn't enumerated).
supported_durationsValid output durations in seconds (video). Empty/null → use min_output_duration/max_output_duration instead.
default_duration / min_output_duration / max_output_durationVideo output bounds.
images_per_requestFixed-output-N override (e.g. Midjourney = 4 regardless of num_images).

Input constraints

FieldDescription
max_reference_imagesCap on reference_images / source_images for image tools (text_to_img, image_editing, creative_director, text_to_video).
max_imagesCap on reference_images for video-to-video models.
max_videos / max_elements / max_audioVideo-to-video secondary input caps.
elements_max_images / elements_max_videos / elements_max_audioCap on the corresponding inputs for elements models.
max_visual_dnaCap on visual_dna_ids.
supports_visual_dnaAuthoritative boolean — prefer this over inferring from max_visual_dna > 0.
max_total_mediaCombined media-input cap (when set).
min_video_duration / max_video_durationSource-video duration range for lipsync-video and video_to_video (distinct from output durations above).
min_audio_duration / max_audio_durationAudio-input duration range for lipsync / elements audio.
audio_max_follows_video_durationWhen true, audio is also capped at the source-video duration.
min_recording_duration / max_recording_durationRecording-driven inputs (speech models).
supported_audio_formatse.g. ["mp3","wav","m4a"]. Empty = all formats accepted.
supports_audio_inputWhether the model accepts a background-music input on text-to-video.
max_file_sizePer-upload size cap in bytes.
requires_prompt / min_prompt_length / max_prompt_lengthPrompt validation.
use_character_reference / supports_first_last_frame / supports_custom_loraCapability gates.

Sound generation (video output)

FieldDescription
sound_generation_type"native" (model emits synced audio) or "none".
sound_enabled_by_defaultWhether sound is on if sound_enabled is omitted.
sound_credit_multiplierExtra multiplier when sound is enabled (e.g. 1.5×).

Cost formula

final_cost = credit
           × (resolution_multipliers[resolution] || 1)
           × (sound_enabled ? sound_credit_multiplier : 1)
           × (duration_seconds  ?? 1)    // video tools
           × (num_images        ?? 1)    // image tools

For exact charged numbers, read credits_used from the generation response — that's the authoritative server-side total, multiplier-adjusted.

Available Image Models

Loading text_to_img models...

Available Image Editing Models

Loading image_editing models...

Available Text-to-Video Models

Loading text_to_video models...

Available Image-to-Video Models

Loading img_to_video models...

Available Draw-to-Video Models

Loading draw_to_video models...

Available Video-to-Video Models

Loading video_to_video models...

Available Elements Models

Loading elements models...

Available First & Last Frame Models

Loading firstlastgenerations models...

Available Lipsync Models (Image Source)

Loading lipsync-image models...

Available Lipsync Models (Video Source)

Loading lipsync-video models...

Available Music Models

Loading music_gen models...

Available Speech Models

Loading text_to_speech models...

Available Sound Models

Loading text_to_sound models...

Available Chat Models

Loading text models...

Available 3D Models

Loading three_d models...

Available Transcription Models

Loading stt models...

Credit Costs

Credits are the universal currency for all generations. 1 credit = $0.01.

Pricing by Type

TypePricing Model
ChatFlat rate per completion
ImageFlat rate per generation (typically 2-10 credits)
Image EditingFlat rate per generation (typically 2-10 credits)
Video (text/image/video-to-video)Per-second: model.credit x duration_seconds
MusicFlat rate per generation
SpeechPer 100 characters: ceil(chars / 100) x model.credit
SoundFlat rate per generation
LipsyncPer-second: model.credit x duration_seconds
3DFlat rate per generation
ElementsPer-second: model.credit x duration_seconds
First & Last FramePer-second: model.credit x duration_seconds
TranscriptionFlat rate per transcription

Exact costs are shown in the live tables above. The credit field on each model is always up to date.

Credit Multipliers

The base credit price shown on each model is the base cost at the default tier. Two optional selections on some models — resolution and audio — multiply the base cost.

Resolution Multipliers (resolutionMultipliers)

When you pass a resolution parameter (or when a model has a tier selector in the UI), the final cost is base × resolutionMultiplier[tier].

Examples from production models:

Model familyBaseMultipliers
Most image models (Nano Banana, Flux, Imagen, Qwen)1.0"1K": 1.0, "2K": 1.0, "4K": 1.0 — flat across tiers
SeeDream 5.01.0"1K": 1.0, "2K": 1.0, "4K": 2.0 — 4K costs
Kling v2.x text-to-video1.0"720p": 1.0, "1080p": 1.5 — 1080p costs 1.5×
ByteDance Seedance UHD1.0"1080p": 1.0, "1440p": 2.0, "2160p": 4.0 — 4K costs
Hailuo i2v1.0"512P": 1.0, "1024P": 3.0 — 1024P costs
Kling / WAN low-tier1.0"360p": 0.75, "540p": 0.75, "720p": 1.0, "1080p": 2.0 — 1080p costs , sub-HD is cheaper

The exact multiplier map is on each model document. Call GET /api/v1/models and read resolutionMultipliers to know the cost at every tier before you submit. Omitting resolution uses the model default tier (multiplier 1.0 in most cases).

Audio Multipliers (soundCreditMultiplier)

Some video models generate native audio when enabled. When the underlying session or controller sets soundEnabled: true (Creative Director video scenes, Veo 3.1, Pixverse V6, etc.), the final cost is base × soundCreditMultiplier.

Examples:

ModelsoundCreditMultiplier
Most video models (no native audio)1.0 — no change
Veo 3.1 Lite1.6 — audio adds 60%
Pixverse V62.0 — audio doubles the cost

Both multipliers compound when a model has both:

final = base × resolutionMultiplier[tier] × (soundEnabled ? soundCreditMultiplier : 1.0) × durationSeconds

The per-second base (credit), the tier map (resolutionMultipliers), and soundCreditMultiplier are all fields on the model document — they stay authoritative there, not in this doc.

Auto-Selection

If you omit the model parameter, Kolbo's Smart Select automatically chooses the best model for your prompt. This is recommended for most use cases.