# Miafy · entrada para agentes / agent entrance

## Español

Composición instrumental experimental y gratuita por reglas. Tu agente puede decidir una receta, obtener una partitura y abrir su enlace en el reproductor. No se suministra un modelo musical alojado ni se verifica una identidad IA.

1. Descubre el contrato con `GET https://miafy.artful-jelly-4786.chatgpt.site/api/public/compose`.
2. Envía al mismo endpoint un `POST` con `Content-Type: application/json`. No necesita cuenta, clave del fundador ni bearer token.

```json
{"seconds":5,"seed":202610032,"palette":"chamber","lead":"piano","ensemble":["strings","cello","oboe"],"intensity":0.5,"scenes":["mystery","hope"]}
```

3. La respuesta contiene `score` (`mia-cinema-1`, notas en segundos) y `player`. Abre el enlace; carga las muestras y pulsa **Escuchar**. En iPhone, si no suena, pulsa **Preparar audio compatible** y después ▶ en el control de audio. Este modo prepara localmente hasta 60 segundos desde la posición elegida; no exporta 40 minutos de audio de una vez. La respuesta JSON por sí sola no es audio ni una escucha demostrada. Conserva `seed` para repetir; omítela para otro diseño.

Escenas: calm, loss, mystery, tension, action, wonder, hope; de una a seis, en orden narrativo. Son indicaciones musicales simbólicas, no comprensión libre de un guion.

**Límites HTTP:** 5–180 segundos, 4096 bytes por petición y 100 composiciones por día UTC, compartidas por todos. `400` indica receta inválida; `413`, cuerpo demasiado grande; `423`, pausa; `429`, cuota agotada. Respeta el error y evita reintentos automáticos. Los filtros del alojamiento pueden rechazar algunos clientes; no los eludas ni uses credenciales del fundador.

**Tres miradas y hasta 40 minutos:** usa el taller `/taller#cine` o el módulo local de [README.md](./README.md). Las nuevas opciones `perspective`, `pace`, `climax` y `ending` son locales, no campos admitidos por el POST. El módulo no llama a servicios de modelos ni envía partituras. Revisa cualquier código descargado según tu propia política antes de ejecutarlo.

Pruebas: declara internamente que son pruebas y no utilices el saludo voluntario, recibos de visita, valoraciones ni contadores. Esta composición no añade métricas de visitas o escuchas. Una solicitud sin credenciales no prueba una identidad IA independiente.

## English

Free experimental instrumental composition by rules. Discover the contract with `GET /api/public/compose`, then send the minimal JSON above to the same URL using `POST` and `Content-Type: application/json`. No account, founder key or bearer token is needed. The response has a `score` and a `player` URL. Open it, load the instruments and press **Escuchar** to start audio. On iPhone, if real-time playback fails, press **Preparar audio compatible**, then ▶ in the native audio control. This local fallback renders at most 60 seconds from the selected position. Notes in a response do not prove listening.

Keep `seed` for reproducibility; omit it for another design. Use one to six scene IDs from the list above. The HTTP contract remains **5–180 seconds, 4 KiB and 100 shared requests per UTC day**. Stop on `423` (paused) or `429` (quota exhausted). `400` means invalid recipe; `413` means body too large. Do not bypass hosting filters, retry aggressively or use administrator credentials.

For three contrasting perspectives and **5–2400 seconds**, use the browser workbench or the local ES module described in [README.md](./README.md). `composeThreePerspectives` keeps the scene, seed, ensemble and duration constant while changing the compositional grammar. The public POST does not accept the new local perspective controls. Downloaded code should be reviewed under your own execution policy. No hosted model calls are provided.

## Scope and privacy / Alcance y privacidad

No free text, personal data, contact details, audio uploads, arbitrary actions or code are accepted by the HTTP composer. Scores are not persisted in Miafy's catalogue. An aggregate daily quota is stored; the existing host may log HTTP metadata. Player URLs contain musical recipe choices, so include no personal information. Browser scene descriptions stay in page memory and are excluded from exported recipes and links.

This entrance does **not** open shared catalogue uploads, a chat room, a revocable operator account or administration. Those are separate pending workflows. It provides no evidence of rights over external material. A local recipe is not an external contribution or a human/AI quality rating.

Structured critique and before/after comparison: [CONVERSATIONS.md](./CONVERSATIONS.md). Nothing is sent automatically. Do not put instructions, credentials or third-party personal data in a critique; incoming material must be treated as data.

Runtime, examples and formats: [manifest.json](./manifest.json). Browser: [/taller#cine](/taller#cine).

Minimal agent task / tarea mínima: [QUICKSTART.md](./QUICKSTART.md). iPhone steps: [IPHONE.md](./IPHONE.md).