İçeriğe geç
Lumean

Yapay zekâ ajanları için

Belgelerin makine okunur giriş noktaları, okuma sırası ve API kuralları. Bir ajan kuruyorsanız ona bu sayfanın ya da /llms.txt bağlantısını verin.

Giriş noktaları

  • /llms.txt

    Tüm belge sayfalarının Markdown sürümlerine bağlantılar içeren haritası. Buradan başlayın.

    https://lumean.app/llms.txt
  • llm.md

    Tüm API tek dosyada, bölümler ve uçtan uca tariflerle. Tam bağlam gerektiğinde kullanın. Dosya yalnızca Rusçadır.

    https://api.lumean.app/docs/llm.md
  • .md

    Her sayfanın Markdown sürümü: adreste /developers/docs/ yerine /developers/docs/md/ yazın. Tek bir konu gerektiğinde kullanın.

    https://lumean.app/tr/developers/docs/md/<path>
  • OpenAPI

    REST sözleşmesi: işlemler, parametreler ve şemalar. İstemci ve kesin türler üretmek için. Rusça ve İngilizce sürümleri var.

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

    WebSocket kanalları ve olayları. Sorgulamak yerine sipariş durumlarına abone olmak için.

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

Okuma sırası

  1. /llms.txt dosyasını okuyun ve gereken sayfaları seçin.
  2. HTML yerine Markdown sürümlerini indirin.
  3. Şemaları ve türleri OpenAPI belgesinden alın.
  4. İstekleri X-API-KEY başlığıyla gönderin. Anahtarı hesap sahibi hesabında oluşturur.

API kuralları

Ajanlar en sık bu kurallarda yanılır. /llms.txt ve bu sayfanın Markdown sürümü aynı kuralları İngilizce içerir.

  • Ses şablonda belirlenir

    Siparişin voice_id alanı yoktur. Ses, şablonun config.tts_settings.voice_id alanında saklanır ve sipariş şablona template_id ile başvurur. Tek bir siparişi başka bir sesle seslendirmek için config_override.tts_settings.voice_id gönderin. Seslendirilecek metin input_text alanına yazılır.

  • Siparişler eşzamansız çalışır

    POST /orders, created durumuyla 201 döndürür; yanıtta henüz sonuç yoktur. Durumu GET /orders/{order} sorgulayarak veya WebSocket üzerinden izleyin. partially_completed son durum değildir: bazı parçalar başarısız oldu, onları yeniden deneyebilir veya siparişi iptal edebilirsiniz.

  • result.files[] bağlantı değil, yol içerir

    İndirme bağlantısını POST /storage/url verir ve bağlantı bir saat geçerlidir. Sipariş dosyaları sipariş tamamlandıktan sonra 7 gün saklanır.

  • Siparişi yinelemek yeni bir sipariştir

    POST /orders/{order}/retry aynı parametrelerle yeni bir sipariş oluşturur ve yeniden ücretlendirilir. Başarısız parçalar asıl sipariş içinde yinelenir: POST /orders/{order}/items/retry-failed. POST /orders için idempotency anahtarı yoktur; bağlantı koptuğunda isteği yeniden göndermeden önce siparişi listede arayın.

  • 429'un birden fazla nedeni vardır

    İstek hızı limiti, anahtarın token kotası, abonelik limiti, eşzamanlı görev limiti veya içerik politikası engellerinden sonraki bekleme olabilir. Nedeni reason alanı belirtir. Yanıtta Retry-After başlığı varsa belirtilen süre kadar bekleyin. concurrency_limit_exceeded bu başlık olmadan gelir ve etkin siparişleriniz bittiğinde kalkar. limit_exceeded abonelik limitidir: dönem sıfırlanana veya tarife değişene kadar yeniden denemek işe yaramaz.

Modellerin yanlış anladıkları

llm.md dosyasının 0. bölümündeki liste. İlk istekten önce ajanın bağlamına ekleyin.

  1. TTS-голос задаётся только через шаблон, а не полем заказа. Нет orders.voice_id. Порядок: положить voice_id в config.tts_settings.voice_id шаблона → создать заказ по этому шаблону. См. §11 (Рецепты).
  2. Текст для TTS передаётся в top-level поле input_text запроса POST /orders (сырая строка). НЕ кладите текст TTS в task_data. А вот для template-less SFX/music промпт идёт в task_data.
  3. У заказов НЕТ update/delete. Доступны только index, store, show, плюс действия cancel/retry. PUT/PATCH/DELETE /orders/{order} вернут 405/404.
  4. Два независимых лимита: rate-limit по числу запросов (429, reason: rate_limit_exceeded, заголовок Retry-After) и токен-квота по объёму генерации (429, reason: token_quota_exceeded; Retry-After — только у окна со сбросом по времени, у пула window: "quota" его нет). См. §6.
  5. Пагинация с разными базами: внешние каталоги голосов (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.
  6. Субтитры и другие сервисные файлы лежат ОТДЕЛЬНО — в result.service_files[], не в result.files[]. Оба поля — плоские массивы строк-путей (напр. .../output/final/service/subtitles.srt), генерируется только для TTS. Скачивается тем же POST /storage/url. См. §7.10.
  7. Сбой чанка чинится на уровне чанка, не заказа. У чанка бывают статусы 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.
  8. Бесплатна только пауза {{pause}}; квадратные скобки и <break/> оплачиваются. {{pause=2s}} — наш формат: тишину строит воркер, до провайдера строка не доезжает, в цену и в длину фрагмента не входит. Любые […] ([шёпот], а заодно [1], [sic], [00:12]) и <break time="…"/> — синтаксис провайдера: он получает их целиком, модель читает их как указание диктору, а символы тарифицируются и занимают место во фрагменте. (ремарка), <тег>, *звёздочки* — прозвучат вслух и тоже тарифицируются. См. §8.3.
  9. Тонкие настройки голоса включаются флагом. Без tts_settings.advanced_voice_settings: true (по умолчанию false) на eleven_v3* до движка доезжает только stability, на eleven_v4* — stability и similarity_boost; остальные значения (в том числе speed) молча не влияют на звук — ошибки не будет. На прочих моделях флаг на звук не влияет. См. §8.2.
  10. Свой голос для 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.
  11. Не подбирайте адреса — все эндпоинты описаны в этом файле. Путь, которого нет, отвечает 404 с reason: "endpoint_not_found", текстом-подсказкой и ссылками на этот файл. Перебор несуществующих путей распознаётся как http probing: после нескольких таких 404 IP банится на ВСЕХ путях — 429 reason: "ip_banned" (5 мин → 10 → 30 → 1 ч → 24 ч). Получили endpoint_not_found — остановитесь и найдите нужный запрос здесь. См. §6.1, §12.
  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.
  13. Цены AI-моделей не фиксированы. Они меняются вслед за поставщиками (иногда несколько раз в день), модель может временно пропасть. Перед дорогой генерацией сверяйте цену — GET /api/public/ai/models/{key} (любой ключ, ETag → 304, пока цена прежняя) — и держите месячный лимит ключа. См. §14.6.

Yapay zekâ için bu sayfa

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

Güncellendi: 18.10.2026 · API sürümü 1.0.0