OrderRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/sfxmint-com/json-schema/sfxmint-com-order-request-schema.json",
  "title": "OrderRequest",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sfxmint-com-openapi.yml#/components/schemas/OrderRequest",
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The sound in plain words, in any language: what it is for and what should be heard. Leave lengths to duration_s."
    },
    "variations": {
      "type": "integer",
      "enum": [
        1,
        2,
        4
      ],
      "default": 4,
      "description": "Takes to make."
    },
    "duration_s": {
      "description": "Longest a take may be, in seconds; left out or \"auto\", SFXMint chooses.",
      "oneOf": [
        {
          "type": "number",
          "enum": [
            0.2,
            0.5,
            1,
            1.5,
            2,
            2.5,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10
          ]
        },
        {
          "const": "auto"
        }
      ]
    },
    "enhance": {
      "type": "boolean",
      "default": false,
      "description": "Write the prompt into a full sound description first."
    },
    "refine": {
      "type": "object",
      "description": "Change a take instead of making a new one (free): {from: <order_id>, take, change}."
    }
  }
}