Zum Inhalt
Lumean API

Werkzeuge und KI

Maschinenlesbare Darstellungen dieser Dokumentation: eine Datei für Sprachmodelle, zwei Spezifikationen für HTTP-Clients und eine Karte für Agenten. Dazu eine ehrliche Liste dessen, was diese Dateien nicht leisten.

llm.md — die Datei für Modelle

llm.md2641 Zeilen · 15 Abschnitte · 8 Rezepte · 214 KB · Aktualisiert 2026-10-16

Eine einzige Datei, die die API so beschreibt, wie ein Modell sie lesen sollte: exakte Validierungsregeln für Bodies, durchgehende Rezepte und ein eigener Abschnitt zu den häufigsten Missverständnissen. Es ist dieselbe Quelle, aus der die Leitfäden dieses Bereichs geschrieben wurden.

llm.md öffnen

Es gibt nur eine Datei, und sie ist auf Russisch: Lokalisierte Fassungen von llm.md existieren nicht.

Abschnitte: 15

Nr.Abschnitt der DateiDasselbe für Menschen
§0Что это за APIÖffnen
§1TL;DR — путь от нуля до готового TTS-заказаÖffnen
§2Базовый URL и окруженияÖffnen
§3Аутентификация — заголовок `X-API-KEY`Öffnen
§4СоглашенияÖffnen
§5Типы заказов (`task_type`)Öffnen
§6Лимиты: rate-limit и токен-квотаÖffnen
§7Справочник эндпоинтовÖffnen
§8Тела POST-запросов (точные правила валидации)Öffnen
§9Схемы ресурсов (ключи в user-контексте)Öffnen
§10Real-time (WebSocket) — статус заказов и клонов голоса без поллингаÖffnen
§11Рецепты (сквозные примеры)Öffnen
§12Коды ответов (сводка)Öffnen
§13FAQ / частые ошибки для LLMÖffnen
§14AI API (OpenAI- и Anthropic-совместимый)—

Rezepte: 8

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

Was Modelle am häufigsten falsch verstehen

Die Liste direkt aus llm.md. Fügen Sie sie in den Chat ein, bevor Sie ein Modell um eine Integration bitten: Sie beseitigt die meisten Fehler noch vor der ersten Anfrage.

Fertiger Block für den Chat

  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, без Retry-After) и токен-квота по объёму генерации (429, reason: token_quota_exceeded, с Retry-After). См. §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. Любые квадратные скобки в тексте озвучки вырезаются — это разметка для диктора, а не список ключевых слов. [1], [sic], [00:12] не прозвучат (и не будут оплачены). А вот (ремарка), <тег>, *звёздочки* — прозвучат и тарифицируются. См. §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.

Spezifikationen

OpenAPI JSON — russisch

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

55 Operationen · 44 Schemata

Datei öffnen

OpenAPI JSON — englisch

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

55 Operationen · 44 Schemata

Datei öffnen

AsyncAPI JSON

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

6 Kanäle · 29 Ereignisse

Datei öffnenBereich Realtime

Was Sie nach dem Import sehen

Die Sammlung heißt „Laravel“, Version 0.0.1. Das ist die Voreinstellung des Generators im Backend, kein Produktname und keine API-Version: Benennen Sie die Sammlung bei sich um, sonst finden Sie sie in einem Monat nicht wieder.

Es gibt nur zwei Spezifikationen, eine russische und eine englische: Die deutsche, türkische und spanische Seite liefern die englische Datei aus. Sie unterscheiden sich nur in der Sprache der Beschreibungen — der Operationsumfang ist identisch.

Import in Postman, Insomnia, Bruno

Alle drei importieren OpenAPI direkt über eine URL, ohne Download. Kopieren Sie die Spezifikations-Adresse oben und fügen Sie sie im Import-Dialog ein.

  • Postman

    Import → Link → die Spezifikations-URL. Sie kommt als Sammlung an; die Basis-URL übernimmt Postman selbst aus servers.

  • Insomnia

    Create → Import From → URL. Insomnia legt ein Spezifikationsdokument an; die Anfragesammlung erzeugt die Schaltfläche daneben.

  • Bruno

    Import Collection → OpenAPI V3. Bruno liest eine lokale Datei — speichern Sie die Spezifikation daher zuerst über den Link.

Tipp

Kein Client trägt den Schlüssel für Sie ein: Setzen Sie den Header X-API-KEY auf Sammlungsebene und verwenden Sie https://api.lumean.app/api/public als Basis-URL.

Für Agenten

Eine Karte dieses Bereichs für KI-Agenten mit Links zur Markdown-Fassung jeder Seite. Jede Dokumentationsseite hat einen .md-Zwilling: derselbe Inhalt ohne Oberflächen-Markup.

/llms.txt öffnen.md öffnen

Diese Seite einer KI geben

.md öffnenllm.md

Aktualisiert 16.10.2026 · Spezifikation 0.0.1