کاوش

کاتالوگ به‌روز مدل‌ها و وضعیت حساب شما. هیچ‌کدام از این دو از سهمیه شما کم نمی‌کنند.

کاتالوگ مدل‌ها

GET

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

/models/

همه مدل‌ها، پارامترهایی که می‌پذیرند و هزینه فعلی هر کدام به اعتبار، به تفکیک نوع مدیا. این اندپوینت مرجع معتبر قیمت‌ها و مقادیر مجاز aspect_ratio، duration، quality و model_level است؛ به‌جای اینکه جدول‌های این داکیومنت را در کدتان ثابت بنویسید، آن را هنگام راه‌اندازی برنامه بخوانید. رفتار /images/ با aspect_ratio خارج از فهرست، در بخش «مدل‌های تصویر» در صفحه معرفی توضیح داده شده است.

قیمت ویدیو به‌صورت credits_min و credits_max به‌همراه جدول credits_by_level_duration_quality برگردانده می‌شود که کلیدهایش به شکل level/duration/quality است (در مدل‌های بدون سطح، بخش level/ وجود ندارد). kling-motion، genjutsu و lipsync مدت را از ورودی می‌گیرند؛ بنابراین جدولشان قیمت یک خروجی فرضی 5 ثانیه‌ای را نشان می‌دهد (با کلیدهایی مثل 2.6/5/720 یا v3/5/auto) و هزینه واقعی به نسبت تعداد ثانیه‌ها محاسبه می‌شود. قیمت ثابت gemini-omni-video با ورودی ویدیویی در این جدول نیامده است.

کاتالوگ مدل‌ها › پاسخ‌ها

کاتالوگ مدل‌ها.

ModelCatalog

object · الزامی

یک map از آیدی مدل به آبجکت قابلیت‌های آن. هر مورد name و pricing دارد؛ کلیدهای دیگر پارامترهای مدل را توصیف می‌کنند و از مدلی به مدل دیگر فرق دارند: 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 و notes. مدل‌های chatgpt-image-2.5-* فیلدهای levels، default_level و backgrounds را هم دارند و pricing آن‌ها held_credits_by_level (به ترتیب سطح، کیفیت و نسبت تصویر) و held_credits_per_input_image را اضافه می‌کند؛ pricing مدل nano-banana-2-1 هم credits_per_input_image و rounding دارد. مدل‌های موسیقی max_prompt_chars_simple_mode و max_style_chars را هم دارند و مدل‌های گفتار max_lines، min_characters، max_unique_voices، voices و languages را.

GET/models/

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

نمونه پاسخ‌ها

{
  "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

موجودی اعتبار

GET

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

/credits/

موجودی فعلی شما و سهمیه دقیقه‌ای درخواست‌های نوشتنی که این کلید مشمول آن است. این درخواست از سهمیه شما کم نمی‌کند، پس می‌توانید پیش از هر دسته درخواست با خیال راحت آن را call کنید.

موجودی اعتبار › پاسخ‌ها

وضعیت حساب.

credits

integer · الزامی

اعتبار موجود در حال حاضر.

rate_limit_per_minute

integer · الزامی

تعداد ارسال‌های تولید مجاز در هر دقیقه، در مجموع همه کلیدهای شما.

آپلودها

کاتالوگ مدل‌ها

GET

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

/models/

کاتالوگ مدل‌ها › پاسخ‌ها

کاتالوگ مدل‌ها.

ModelCatalog

object · الزامی

موجودی اعتبار

GET

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

/credits/

موجودی اعتبار › پاسخ‌ها

وضعیت حساب.

credits

integer · الزامی

اعتبار موجود در حال حاضر.

rate_limit_per_minute

integer · الزامی

تعداد ارسال‌های تولید مجاز در هر دقیقه، در مجموع همه کلیدهای شما.