Para agentes de IA

Puntos de entrada

• /llms.txt

  Un mapa de todas las páginas de la documentación con enlaces a sus versiones Markdown. Empiece aquí.

  https://lumean.app/llms.txtCopy the link
• llm.md

  Toda la API en un archivo, con secciones y recetas de principio a fin. Úselo cuando necesite el contexto completo. El archivo solo está en ruso.

  https://api.lumean.app/docs/llm.mdCopy the llm.md link
• .md

  La versión Markdown de cualquier página: sustituya /developers/docs/ en la dirección por /developers/docs/md/. Úsela cuando necesite un solo tema.

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

  El contrato REST: operaciones, parámetros y esquemas. Para generar un cliente y tipos exactos. Disponible en ruso e inglés.

  https://api.lumean.app/docs/public-openapi.en.jsonCopy the link
• AsyncAPI

  Canales y eventos de WebSocket. Para suscribirse a los estados de los pedidos en lugar de consultarlos.

  https://api.lumean.app/docs/public-asyncapi.en.jsonCopy the link

Orden de lectura

1. Lea /llms.txt y elija las páginas que necesita.
2. Descargue sus versiones Markdown, no el HTML.
3. Tome los esquemas y tipos de OpenAPI.
4. Envíe las solicitudes con el encabezado X-API-KEY. La clave la crea el titular de la cuenta en su cuenta.

Reglas de la API

Los agentes fallan en estas reglas con más frecuencia. /llms.txt y la versión Markdown de esta página contienen las mismas reglas en inglés.

• La voz se define en la plantilla

  Un pedido no tiene campo voice_id. La voz se guarda en config.tts_settings.voice_id de la plantilla, y el pedido hace referencia a la plantilla con template_id. Para locutar un solo pedido con otra voz, envíe config_override.tts_settings.voice_id. El texto a locutar va en input_text.

• Los pedidos se ejecutan de forma asíncrona

  POST /orders responde 201 con estado created y todavía sin resultado. El estado se consulta con GET /orders/{order} o por WebSocket. partially_completed no es un estado final: algunos fragmentos fallaron y puede reintentarlos o cancelar el pedido.

• result.files[] contiene rutas, no enlaces

  El enlace de descarga lo devuelve POST /storage/url y es válido durante una hora. Los archivos del pedido se conservan 7 días después de que termina.

• Repetir un pedido crea un pedido nuevo

  POST /orders/{order}/retry crea un pedido nuevo con los mismos parámetros y se cobra de nuevo. Los fragmentos fallidos se reintentan dentro del pedido original: POST /orders/{order}/items/retry-failed. POST /orders no tiene clave de idempotencia, así que tras un corte de conexión busque primero el pedido en la lista.

• Un 429 tiene varias causas

  Puede ser el límite de frecuencia de solicitudes, la cuota de tokens de la clave, un límite de la suscripción, el límite de tareas simultáneas o una pausa tras bloqueos de la política de contenido. La causa la indica el campo reason. Si la respuesta trae un encabezado Retry-After, espere el tiempo que indica. concurrency_limit_exceeded llega sin él y se levanta cuando terminan sus pedidos activos. limit_exceeded es el límite de la suscripción: reintentar no sirve hasta que se reinicie el periodo o cambie el plan.

Lo que los modelos entienden mal

La lista de la sección 0 de llm.md. Añádala al contexto del agente antes de la primera solicitud.