Discovery

The live model catalog and your account state. Neither counts against your quota.

Model catalog

GET

https://api.hoosha.com/api/v1

/models/

Every model, its parameter surface and its current credit cost, grouped by media type. This is the authoritative source for pricing and for the legal values of aspect_ratio, duration, quality and model_level — read it at startup rather than hard-coding the tables in this document. How /images/ treats an aspect_ratio outside the list is described under Image models on the overview.

Video pricing is returned as credits_min / credits_max plus a credits_by_level_duration_quality grid keyed level/duration/quality (the level/ segment is absent for models without levels). kling-motion, genjutsu and lipsync take their length from the input, so their grid prices a nominal 5-second output (keys such as 2.6/5/720 or v3/5/auto) and the real charge scales per second. The flat price of gemini-omni-video with a video input is not in the grid.

Model catalog › Responses

The catalog.

ModelCatalog

object · required

Model id → capability object. Every entry carries name and pricing; the other keys describe the parameter surface and vary by model: aspect_ratios, durations, qualities, default_quality, model_levels, mode_model_levels, modes, defaults, sync_modes, output_formats, max_prompt_chars, max_input_images, image_input, video_input, audio_input, requires_video_input, requires_audio_input, has_audio and notes. The chatgpt-image-2.5-* models add levels, default_level and backgrounds, and their pricing adds held_credits_by_level (level → quality → aspect ratio) and held_credits_per_input_image; nano-banana-2-1 pricing adds credits_per_input_image and rounding. Music models add max_prompt_chars_simple_mode and max_style_chars; speech models add max_lines, min_characters, max_unique_voices, voices and languages.

GET/models/

curl https://api.hoosha.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "models": {
    "image": {
      "hoosha-v1": {
        "name": "Hoosha V1",
        "max_prompt_chars": 20000,
        "image_input": true,
        "max_input_images": 5,
        "aspect_ratios": [
          "auto",
          "1:1",
          "9:16",
          "16:9",
          "3:4",
          "4:3",
          "3:2",
          "2:3"
        ],
        "pricing": {
          "credits": 5
        }
      },
      "nano-banana-2-pro": {
        "name": "Nano Banana 2",
        "max_prompt_chars": 20000,
        "image_input": true,
        "max_input_images": 14,
        "aspect_ratios": [
          "auto",
          "1:1",
          "9:16",
          "16:9",
          "2:3",
          "3:2",
          "3:4",
          "4:3"
        ],
        "qualities": [
          "1K",
          "2K",
          "4K"
        ],
        "default_quality": "2K",
        "pricing": {
          "credits_by_quality": {
            "1K": 9,
            "2K": 11,
            "4K": 14
          }
        }
      }
    },
    "video": {
      "veo3": {
        "name": "Veo 3.1",
        "max_prompt_chars": 60000,
        "image_input": true,
        "aspect_ratios": [
          "16:9",
          "9:16"
        ],
        "durations": [
          "8"
        ],
        "qualities": [
          "720"
        ],
        "defaults": {
          "aspect_ratio": "9:16",
          "duration": "8",
          "quality": "720"
        },
        "has_audio": true,
        "pricing": {
          "credits_min": 30,
          "credits_max": 30,
          "credits_by_level_duration_quality": {
            "8/720": 30
          }
        }
      }
    },
    "music": {
      "suno-v6": {
        "name": "Suno V6",
        "max_prompt_chars": 5000,
        "max_prompt_chars_simple_mode": 3000,
        "max_style_chars": 1000,
        "pricing": {
          "credits": 15
        }
      }
    },
    "speech": {
      "eleven-dialogue-v4": {
        "name": "ElevenLabs v4",
        "min_characters": 5,
        "max_characters": 5000,
        "max_lines": 6,
        "max_unique_voices": 10,
        "default_stability": "0.5",
        "voices": [
          {
            "id": "EkK5I93UQWFDigLMpZcX",
            "name": "شایان",
            "description": "گوینده",
            "gender": "male"
          }
        ],
        "languages": [
          "fa",
          "en",
          "ar",
          "tr",
          "fr",
          "de",
          "es",
          "ru"
        ],
        "pricing": {
          "credits_per_1000_chars": 12,
          "rounding": "up, per request"
        }
      }
    }
  }
}

json

application/json

Credit balance

GET

https://api.hoosha.com/api/v1

/credits/

Your current balance and the per-minute write quota this key is subject to. It does not count against your quota, so it is safe to call before every batch.

Credit balance › Responses

Account state.

credits

integer · required

Credits currently available.

rate_limit_per_minute

integer · required

Generation submissions allowed per minute across all your keys.

Uploads

Model catalog

GET

https://api.hoosha.com/api/v1

/models/

Model catalog › Responses

The catalog.

ModelCatalog

object · required

Credit balance

GET

https://api.hoosha.com/api/v1

/credits/

Your current balance and the per-minute write quota this key is subject to. It does not count against your quota, so it is safe to call before every batch.

Credit balance › Responses

Account state.

credits

integer · required

Credits currently available.

rate_limit_per_minute

integer · required

Generation submissions allowed per minute across all your keys.