Araçlar ve yapay zekâ

Bu dokümantasyonun makine okunur görünümleri: dil modelleri için bir dosya, HTTP istemcileri için iki spesifikasyon ve ajanlar için bir harita. Ayrıca bu dosyaların size neleri vermediğinin dürüst bir listesi.

llm.md — modeller için dosya

llm.md2641 satır · 15 bölüm · 8 tarif · 214 KB · Güncellendi: 2026-10-16

API'yi bir modelin okuması gereken şekilde anlatan tek bir dosya: kesin gövde doğrulama kuralları, uçtan uca tarifler ve en sık yapılan yanlış okumalara ayrılmış bir bölüm. Bu bölümdeki rehberler de aynı kaynaktan yazıldı.

llm.md'yi aç

Tek bir dosya var ve Rusça: llm.md'nin yerelleştirilmiş sürümü yok.

Bölümler: 15

#	Dosyanın bölümü	İnsanlar için karşılığı
§0	Что это за API	Aç
§1	TL;DR — путь от нуля до готового TTS-заказа	Aç
§2	Базовый URL и окружения	Aç
§3	Аутентификация — заголовок `X-API-KEY`	Aç
§4	Соглашения	Aç
§5	Типы заказов (`task_type`)	Aç
§6	Лимиты: rate-limit и токен-квота	Aç
§7	Справочник эндпоинтов	Aç
§8	Тела POST-запросов (точные правила валидации)	Aç
§9	Схемы ресурсов (ключи в user-контексте)	Aç
§10	Real-time (WebSocket) — статус заказов и клонов голоса без поллинга	Aç
§11	Рецепты (сквозные примеры)	Aç
§12	Коды ответов (сводка)	Aç
§13	FAQ / частые ошибки для LLM	Aç
§14	AI API (OpenAI- и Anthropic-совместимый)	—

Tarifler: 8

Рецепт A. TTS на ElevenLabs
Рецепт B. Звуковой эффект (SFX, без шаблона) — полный цикл
Рецепт C. Музыка (без шаблона) — полный цикл, `n_variants` → несколько файлов
Рецепт D. Проверить остаток токенов подписки
Рецепт E. Скачать все файлы готового заказа
Рецепт F. Дотянуть частично готовый заказ (`partially_completed`)
Рецепт G. Квоты подписки не хватило — PAYG-добор
Рецепт H. Cartesia своим голосом: клон → шаблон → заказ

Modellerin en sık yanlış anladıkları

Liste doğrudan llm.md'den. Bir modelden entegrasyon yazmasını istemeden önce sohbete yapıştırın: hataların çoğunu daha ilk istekten önce ortadan kaldırır.

Sohbete yapıştırmaya hazır

TTS-голос задаётся только через шаблон, а не полем заказа. Нет orders.voice_id. Порядок: положить voice_id в config.tts_settings.voice_id шаблона → создать заказ по этому шаблону. См. §11 (Рецепты).
Текст для TTS передаётся в top-level поле input_text запроса POST /orders (сырая строка). НЕ кладите текст TTS в task_data. А вот для template-less SFX/music промпт идёт в task_data.
У заказов НЕТ update/delete. Доступны только index, store, show, плюс действия cancel/retry. PUT/PATCH/DELETE /orders/{order} вернут 405/404.
Два независимых лимита: rate-limit по числу запросов (429, без Retry-After) и токен-квота по объёму генерации (429, reason: token_quota_exceeded, с Retry-After). См. §6.
Пагинация с разными базами: внешние каталоги голосов (voices/elevenlabs/library, voices/heygen) считают page с 0; обычные списки (orders, templates, templates/browse, а также каталог и клоны Cartesia voices/cartesia, voices/cartesia/clones, а также Fish Audio voices/fishaudio, voices/fishaudio/clones) — current_page с 1.
Субтитры и другие сервисные файлы лежат ОТДЕЛЬНО — в result.service_files[], не в result.files[]. Оба поля — плоские массивы строк-путей (напр. .../output/final/service/subtitles.srt), генерируется только для TTS. Скачивается тем же POST /storage/url. См. §7.10.
Сбой чанка чинится на уровне чанка, не заказа. У чанка бывают статусы failed (тех. ошибка) и policy_flagged (контент отклонён политикой провайдера). Частично готовый заказ (partially_completed) доводят до completed так: один вызов POST /orders/{order}/items/retry-failed забирает все failed разом, а policy_flagged добивают поштучно POST /orders/{order}/items/{item}/retry с исправленным text (повтор с тем же текстом бессмыслен). Order-level retry для этого не годится — он создаёт новый заказ. См. §7.11.
Любые квадратные скобки в тексте озвучки вырезаются — это разметка для диктора, а не список ключевых слов. [1], [sic], [00:12] не прозвучат (и не будут оплачены). А вот (ремарка), <тег>, *звёздочки* — прозвучат и тарифицируются. См. §8.3.
Тонкие настройки голоса включаются флагом. Без tts_settings.advanced_voice_settings: true (по умолчанию false) на eleven_v3* до движка доезжает только stability, на eleven_v4* — stability и similarity_boost; остальные значения (в том числе speed) молча не влияют на звук — ошибки не будет. На прочих моделях флаг на звук не влияет. См. §8.2.
Свой голос для Cartesia клонируется по API, но асинхронно. POST /voices/cartesia/clones (право voices.write) сразу отвечает 201 с клоном в статусе pending, а voice_id появляется только в статусе ready — ждите событие voice_clone.updated (§10) или опрашивайте GET /voices/cartesia/clones. В шаблон кладут voice_id клона, а НЕ его id. Клонирование требует живой подписки с Cartesia, только если сервис закрыт для оплаты с баланса (иначе 402 no_subscription), и упирается в потолок клонов: 2 без подписки, лимит тарифа с подпиской. См. §7.12, Рецепт H. То же у Fish Audio (POST /voices/fishaudio/clones, §7.12): правила те же, что у Cartesia, лимит клонов у Fish свой, voice_id — строка из 32 hex-символов, а не UUID.
Не подбирайте адреса — все эндпоинты описаны в этом файле. Путь, которого нет, отвечает 404 с reason: "endpoint_not_found", текстом-подсказкой и ссылками на этот файл. Перебор несуществующих путей распознаётся как http probing: после нескольких таких 404 IP банится на ВСЕХ путях — 429 reason: "ip_banned" (5 мин → 10 → 30 → 1 ч → 24 ч). Получили endpoint_not_found — остановитесь и найдите нужный запрос здесь. См. §6.1, §12.
Есть отдельный AI API (LLM-гейтвей), не входящий в /api/public/*. OpenAI- и Anthropic-совместимые ручки на https://api.lumean.app/v1 (/chat/completions, /responses, /messages, /models, /images/*) работают с ЛЮБЫМ ключом кабинета (Authorization: Bearer или x-api-key), оплата с баланса LUMC. Полностью — §14.
Цены AI-моделей не фиксированы. Они меняются вслед за поставщиками (иногда несколько раз в день), модель может временно пропасть. Перед дорогой генерацией сверяйте цену — GET /api/public/ai/models/{key} (любой ключ, ETag → 304, пока цена прежняя) — и держите месячный лимит ключа. См. §14.6.

Spesifikasyonlar

OpenAPI JSON — Rusça

https://api.lumean.app/docs/public-openapi.json

55 işlem · 44 şema

Dosyayı aç

OpenAPI JSON — İngilizce

https://api.lumean.app/docs/public-openapi.en.json

55 işlem · 44 şema

Dosyayı aç

AsyncAPI JSON

https://api.lumean.app/docs/public-asyncapi.en.json

6 kanal · 29 olay

Dosyayı açRealtime bölümü

İçe aktardıktan sonra ne göreceksiniz

Koleksiyonun adı “Laravel”, sürümü 0.0.1 olacak. Bu, arka uç üretecinin varsayılanıdır; ne bir ürün adı ne de bir API sürümüdür: koleksiyonu kendi tarafınızda yeniden adlandırın, yoksa bir ay sonra bulamazsınız.

Yalnızca iki spesifikasyon var, Rusça ve İngilizce: Almanca, Türkçe ve İspanyolca siteler İngilizce dosyayı sunar. Yalnızca açıklamaların dilinde farklıdırlar — işlem kümesi aynıdır.

Postman, Insomnia, Bruno'ya içe aktarma

Üçü de OpenAPI'yi doğrudan bağlantıdan içe aktarır — indirmeye gerek yok. Yukarıdaki spesifikasyon URL'sini kopyalayın ve içe aktarma penceresine yapıştırın.

Postman
Import → Link → spesifikasyon URL'si. Koleksiyon olarak gelir; Postman temel URL'yi servers alanından kendisi doldurur.
Insomnia
Create → Import From → URL. Insomnia bir spesifikasyon belgesi oluşturur; istek koleksiyonu, yanındaki düğmeyle bu belgeden üretilir.
Bruno
Import Collection → OpenAPI V3. Bruno yerel bir dosya okur, bu yüzden önce spesifikasyonu bağlantıdan kaydedin.

İpucu

Hiçbir istemci anahtarı sizin yerinize eklemez: X-API-KEY başlığını koleksiyon düzeyinde ayarlayın ve temel URL olarak https://api.lumean.app/api/public kullanın.

Ajanlar için

Bu bölümün yapay zekâ ajanları için haritası; her sayfanın markdown sürümüne bağlantı verir. Her dokümantasyon sayfasının bir .md ikizi vardır: arayüz işaretlemesi olmadan aynı içerik.

/llms.txt dosyasını aç .md sürümünü aç

Bu sayfayı yapay zekâya verin

.md sürümünü aç llm.md

Güncellendi: 16.10.2026 · spesifikasyon 0.0.1