/v1/billing/pricing/estimateОценка стоимости запуска
Оценка стоимости операции без побочных эффектов, по вашему тарифу (тот же механизм, что резервирует средства при запуске). Передайте модель и параметры; URL-медиа не нужно — только счётчики референсов.
Замените демонстрационные данные и задайте переменные окружения.
curl --fail-with-body -X POST \
-H "X-API-Key: ${FRANKLAB_KEY:?Set your API key}" \
-H "Content-Type: application/json" \
--data-raw '{"modelId":"mars-v1-5","duration":5,"operation":"text_to_video","mode":"std","resolution":"720p"}' \
"https://apergrex.ru/franklab/api/v1/billing/pricing/estimate"Тело запроса
modelIdstringобязательноИдентификатор модели (как в /studio/models)
durationintegerДлительность видео, секунды (3–30)
operationstringТип операции: text_to_video, image_to_video, reference_to_video, first_last_frame, text_to_image, image_to_image, audio_generation, video_to_video
resolutionstringРазрешение (720p/1080p/4k — зависит от модели; для xAI Image — 1k/2k)
aspectRatiostringСоотношение сторон
modestringРежим модели, если применим
executionModestringМаршрут исполнения (xai_api/supergrok/openai_api/openai_codex)
qualitystringУровень качества: low/medium для gpt-image-2 (codex-маршрут) и xAI Image 2 (low/medium), high — только gpt-image-2
promptstringПромпт (до 3000 символов; нужен для токен-цены google-моделей)
imageCountintegerЧисло входных изображений (MIST i2i)
referenceImageCountintegerЧисло референс-изображений (0–30)
referenceVideoCountintegerЧисло референс-видео (0–10)
referenceAudioCountintegerЧисло референс-аудио (0–10)
imageOutputCountintegerЧисло изображений за запрос, `n` (1–9): множитель цены для xAI Image / Image 2, Kling omni-image (jupiter-v1-5) и GPT Image
voiceCountintegerKling video: число голосов в voice_list запуска (0–10). Надбавка за голос входит в цену, только если в prompt есть разметка <<<voice_N>>>
Квота стоимости по действующему тарифу
Здесь показаны описания ответов из текущего справочника. Схемы и реальные ответы не подменяются демонстрационными данными.
Ключ отсутствует или недействителен
Legacy service-ключи не принимаются: нужен партнёрский API-ключ
Превышен лимит запросов (по умолчанию 60/мин на API-ключ; для сессионных кабинетных операций — на партнёра); заголовок Retry-After даёт секунды до сброса окна