@runware/schemas 0.0.0-20260510231619

package/dist/schemas/requests/types/audio.json

@@ -0,0 +1,676 @@
+{
+  "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "title": "Audio Request",
+  "type": "object",
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "outputFormat": {
+            "enum": [
+              "WAV",
+              "FLAC"
+            ]
+          }
+        },
+        "required": [
+          "outputFormat"
+        ]
+      },
+      "then": {
+        "not": {
+          "required": [
+            "audioSettings"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "outputFormat": {
+            "const": "MP3"
+          }
+        },
+        "required": [
+          "outputFormat"
+        ]
+      },
+      "then": {
+        "properties": {
+          "audioSettings": {
+            "properties": {
+              "sampleRate": {
+                "enum": [
+                  8000,
+                  11025,
+                  12000,
+                  16000,
+                  22050,
+                  24000,
+                  32000,
+                  44100,
+                  48000
+                ]
+              }
+            }
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "enum": [
+                        8000,
+                        11025,
+                        12000
+                      ]
+                    }
+                  },
+                  "required": [
+                    "sampleRate"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 8,
+                      "maximum": 64
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "enum": [
+                        16000,
+                        22050,
+                        24000
+                      ]
+                    }
+                  },
+                  "required": [
+                    "sampleRate"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 8,
+                      "maximum": 160
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "enum": [
+                        32000,
+                        44100,
+                        48000
+                      ]
+                    }
+                  },
+                  "required": [
+                    "sampleRate"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 32,
+                      "maximum": 320
+                    }
+                  }
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "outputFormat": {
+            "const": "OGG"
+          }
+        },
+        "required": [
+          "outputFormat"
+        ]
+      },
+      "then": {
+        "properties": {
+          "audioSettings": {
+            "properties": {
+              "sampleRate": {
+                "enum": [
+                  8000,
+                  12000,
+                  16000,
+                  24000,
+                  48000
+                ]
+              }
+            }
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 8000
+                    },
+                    "channels": {
+                      "const": 1
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 8,
+                      "maximum": 40
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 8000
+                    },
+                    "channels": {
+                      "const": 2
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 16,
+                      "maximum": 80
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 12000
+                    },
+                    "channels": {
+                      "const": 1
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 16,
+                      "maximum": 48
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 12000
+                    },
+                    "channels": {
+                      "const": 2
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 16,
+                      "maximum": 96
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 16000
+                    },
+                    "channels": {
+                      "const": 1
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 16,
+                      "maximum": 96
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 16000
+                    },
+                    "channels": {
+                      "const": 2
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 24,
+                      "maximum": 192
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 24000
+                    },
+                    "channels": {
+                      "const": 1
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 16,
+                      "maximum": 80
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 24000
+                    },
+                    "channels": {
+                      "const": 2
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 32,
+                      "maximum": 160
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 48000
+                    },
+                    "channels": {
+                      "const": 1
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 32,
+                      "maximum": 224
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "sampleRate": {
+                      "const": 48000
+                    },
+                    "channels": {
+                      "const": 2
+                    }
+                  },
+                  "required": [
+                    "sampleRate",
+                    "channels"
+                  ]
+                }
+              },
+              "required": [
+                "audioSettings"
+              ]
+            },
+            "then": {
+              "properties": {
+                "audioSettings": {
+                  "properties": {
+                    "bitrate": {
+                      "minimum": 48,
+                      "maximum": 256
+                    }
+                  }
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "taskType": {
+      "title": "Task Type",
+      "description": "Identifier for the type of task being performed",
+      "type": "string",
+      "const": "audioInference"
+    },
+    "taskUUID": {
+      "title": "Task UUID",
+      "description": "UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.",
+      "type": "string",
+      "format": "uuid"
+    },
+    "webhookURL": {
+      "title": "Webhook URL",
+      "description": "Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.",
+      "type": "string",
+      "format": "uri"
+    },
+    "includeCost": {
+      "title": "Include Cost",
+      "description": "Include task cost in the response.",
+      "type": "boolean",
+      "default": false
+    },
+    "model": {
+      "title": "Model",
+      "description": "Identifier of the model to use for generation.",
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9._-]+(:[a-zA-Z0-9._/@-]+)?$"
+    },
+    "numberResults": {
+      "title": "Number of Results",
+      "description": "Number of results to generate. Each result uses a different seed, producing variations of the same parameters.",
+      "type": "integer",
+      "minimum": 1,
+      "default": 1,
+      "maximum": 4
+    },
+    "uploadEndpoint": {
+      "title": "Upload Endpoint",
+      "description": "URL to upload content via HTTP PUT. The request body will contain the raw binary data.",
+      "type": "string",
+      "format": "uri"
+    },
+    "ttl": {
+      "title": "TTL",
+      "description": "Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.",
+      "type": "integer",
+      "minimum": 60
+    },
+    "outputType": {
+      "title": "Output Type",
+      "description": "Audio output type.",
+      "type": "string",
+      "enum": [
+        "URL",
+        "base64Data",
+        "dataURI"
+      ],
+      "default": "URL"
+    },
+    "outputFormat": {
+      "title": "Output Format",
+      "description": "File format for the generated audio.",
+      "type": "string",
+      "enum": [
+        "MP3",
+        "WAV",
+        "FLAC",
+        "OGG"
+      ],
+      "default": "MP3"
+    },
+    "deliveryMethod": {
+      "title": "Delivery Method",
+      "description": "Determines how the API delivers task results.",
+      "type": "string",
+      "oneOf": [
+        {
+          "const": "sync",
+          "description": "Returns complete results directly in the API response."
+        },
+        {
+          "const": "async",
+          "description": "Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse."
+        }
+      ],
+      "default": "sync"
+    },
+    "audioSettings": {
+      "title": "Audio Settings",
+      "description": "Audio encoding settings. Only applicable for lossy formats (MP3, OGG). Available sample rates and valid bitrate ranges depend on the output format and number of channels.",
+      "type": "object",
+      "properties": {
+        "bitrate": {
+          "title": "Bitrate",
+          "description": "Audio bitrate in kbps.",
+          "type": "integer",
+          "minimum": 8
+        },
+        "channels": {
+          "title": "Channels",
+          "description": "Number of audio channels. 1 for mono, 2 for stereo.",
+          "type": "integer",
+          "enum": [
+            1,
+            2
+          ],
+          "default": 2
+        },
+        "sampleRate": {
+          "title": "Sample Rate",
+          "description": "Audio sample rate in Hz.",
+          "type": "integer"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "taskType",
+    "taskUUID",
+    "model"
+  ]
+}