sfx generate derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "bits": "Bit depth. Overrides the format profile; the override is echoed in formatOverride.",
      "seed": "Integer seed. Omit for a random seed, which is echoed back.",
      "format": "Fidelity profile: wav is 44.1k/16, wav8 is 44.1k/8, retro is 22k/8. Explicit bits/sampleRate override it.",
      "preset": "Preset name or alias. See /sfx/presets for the full list.",
      "sampleRate": "Sample rate in Hz. Overrides the format profile; the override is echoed in formatOverride."
    }
  },
  "output": {
    "type": "object",
    "required": [
      "seed",
      "wav_base64",
      "params"
    ],
    "properties": {
      "seed": {
        "type": "integer",
        "description": "The integer seed used — pass it back for byte-identical output."
      },
      "about": {
        "type": "string",
        "description": "What this response is and where its data comes from, in one sentence."
      },
      "format": {
        "enum": [
          "wav16",
          "wav8",
          "retro",
          "custom"
        ],
        "type": "string",
        "description": "The fidelity profile actually rendered (not necessarily the one requested)."
      },
      "params": {
        "type": "object",
        "properties": {
          "p_duty": {
            "type": "number"
          },
          "p_arp_mod": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "sound_vol": {
            "type": "number"
          },
          "wave_type": {
            "enum": [
              0,
              1,
              2,
              3
            ],
            "type": "integer"
          },
          "p_hpf_freq": {
            "type": "number"
          },
          "p_hpf_ramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_lpf_freq": {
            "type": "number"
          },
          "p_lpf_ramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_pha_ramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_arp_speed": {
            "type": "number"
          },
          "p_base_freq": {
            "type": "number"
          },
          "p_duty_ramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_env_decay": {
            "type": "number"
          },
          "p_env_punch": {
            "type": "number"
          },
          "p_freq_ramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_vib_speed": {
            "type": "number"
          },
          "sample_rate": {
            "type": "integer"
          },
          "sample_size": {
            "enum": [
              8,
              16
            ],
            "type": "integer"
          },
          "p_env_attack": {
            "type": "number"
          },
          "p_freq_dramp": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_freq_limit": {
            "type": "number"
          },
          "p_pha_offset": {
            "type": "number",
            "description": "SIGNED [-1,1]"
          },
          "p_env_sustain": {
            "type": "number"
          },
          "p_repeat_speed": {
            "type": "number"
          },
          "p_vib_strength": {
            "type": "number"
          },
          "p_lpf_resonance": {
            "type": "number"
          }
        },
        "description": "SFXR synthesis parameters. wave_type: 0=square,1=sawtooth,2=sine,3=noise. All p_* are on [0,1] except SIGNED ones on [-1,1]. sample_rate/sample_size reflect the chosen output."
      },
      "preset": {
        "type": "string"
      },
      "clipped": {
        "type": "integer",
        "description": "Samples clamped to range (0 = clean)."
      },
      "related": {
        "type": "object",
        "description": "Next steps as paths on this origin. Each is priced by its own 402 challenge; GET /.well-known/x402 prices the whole origin in one free call.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "mimeType": {
        "enum": [
          "audio/wav"
        ],
        "type": "string"
      },
      "freshness": {
        "type": "object",
        "required": [
          "tier",
          "as_of",
          "age_seconds",
          "max_age_seconds"
        ],
        "properties": {
          "note": {
            "type": "string"
          },
          "tier": {
            "type": "string",
            "example": "nightly"
          },
          "as_of": {
            "type": "string",
            "description": "Newest datum this answer is based on (ISO 8601)."
          },
          "age_seconds": {
            "type": "integer",
            "minimum": 0
          },
          "max_age_seconds": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          }
        },
        "description": "How fresh the data is, measured when you called. `age_seconds` is the number to act on; `max_age_seconds` is the refresh cadence (null = deterministic, cannot go stale)."
      },
      "byteLength": {
        "type": "integer",
        "description": "Total WAV size in bytes."
      },
      "durationMs": {
        "type": "integer"
      },
      "sampleRate": {
        "type": "integer"
      },
      "wav_base64": {
        "type": "string",
        "description": "Base64-encoded WAV (RIFF PCM, mono)."
      },
      "sampleCount": {
        "type": "integer"
      },
      "bitsPerSample": {
        "enum": [
          8,
          16
        ],
        "type": "integer"
      },
      "formatOverride": {
        "type": "object",
        "required": [
          "requested",
          "applied",
          "overriddenBy",
          "detail"
        ],
        "properties": {
          "detail": {
            "type": "string"
          },
          "applied": {
            "enum": [
              "wav16",
              "wav8",
              "retro",
              "custom"
            ],
            "type": "string"
          },
          "requested": {
            "type": "string",
            "description": "The `format` the caller sent."
          },
          "overriddenBy": {
            "type": "array",
            "items": {
              "enum": [
                "bits",
                "sampleRate"
              ],
              "type": "string"
            }
          }
        },
        "description": "Only present when explicit bits/sampleRate overrode the requested `format`."
      }
    }
  }
}