fix: KTV API文档参数命名改为_file规范

2026-07-06 11:59:57 +08:00 · 2026-07-06 11:59:57 +08:00 · 22d9d8540d
commit 22d9d8540d
parent 3eb7d5514c
1 changed files with 25 additions and 25 deletions
--- a/wwwroot/api_doc.md
+++ b/wwwroot/api_doc.md
@ -1857,14 +1857,14 @@ POST /v1/pipeline/submit

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `audio_url` | string | 是 | 音频文件URL（支持 http/https） |
+| `audio_file` | string | 是 | 音频文件URL（支持 http/https） |
 | `language` | string | 否 | 语言代码，默认 `zh` |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-asr-transcribe","audio_url":"https://example.com/audio.mp3","language":"zh"}'
+  -d '{"model":"ky-asr-transcribe","audio_file":"https://example.com/audio.mp3","language":"zh"}'
 ```

 **响应：**
@ -1903,7 +1903,7 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `audio_url` | string | 是 | 音频文件URL |
+| `audio_file` | string | 是 | 音频文件URL |
 | `task_type` | string | 否 | `separate`（默认，两轨）或 `separate_full`（全轨MIDI替换） |

 ```bash
@ -1911,13 +1911,13 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-demucs-separate","audio_url":"https://example.com/music.mp3"}'
+  -d '{"model":"ky-demucs-separate","audio_file":"https://example.com/music.mp3"}'

 # 全轨MIDI替换
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-demucs-separate","audio_url":"https://example.com/music.mp3","task_type":"separate_full"}'
+  -d '{"model":"ky-demucs-separate","audio_file":"https://example.com/music.mp3","task_type":"separate_full"}'
 ```

 **响应（两轨模式）：**
@ -1957,13 +1957,13 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `image_url` | string | 是 | 图像URL |
+| `image_file` | string | 是 | 图像URL |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-face-detect","image_url":"https://example.com/photo.jpg"}'
+  -d '{"model":"ky-face-detect","image_file":"https://example.com/photo.jpg"}'
 ```

 **响应：**
@ -1987,14 +1987,14 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `image_url` | string | 是 | 图像URL |
+| `image_file` | string | 是 | 图像URL |
 | `face_id` | string | 否 | 指定识别目标ID |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-face-recognize","image_url":"https://example.com/face.jpg"}'
+  -d '{"model":"ky-face-recognize","image_file":"https://example.com/face.jpg"}'
 ```

 **响应：**
@ -2018,14 +2018,14 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `image_url1` | string | 是 | 第一张图像URL |
-| `image_url2` | string | 是 | 第二张图像URL |
+| `image_file1` | string | 是 | 第一张图像URL |
+| `image_file2` | string | 是 | 第二张图像URL |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-face-compare","image_url1":"https://example.com/face1.jpg","image_url2":"https://example.com/face2.jpg"}'
+  -d '{"model":"ky-face-compare","image_file1":"https://example.com/face1.jpg","image_file2":"https://example.com/face2.jpg"}'
 ```

 **响应：**
@ -2077,16 +2077,16 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `video_url` | string | 否 | 视频文件URL |
-| `audio_url` | string | 否 | 音频文件URL |
-| `subtitle_url` | string | 否 | ASS字幕文件URL |
+| `video_file` | string | 否 | 视频文件URL |
+| `audio_file` | string | 否 | 音频文件URL |
+| `subtitle_file` | string | 否 | ASS字幕文件URL |
 | `output_format` | string | 否 | 输出格式，默认 `mp4` |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-merge-video","video_url":"https://example.com/video.mp4","audio_url":"https://example.com/audio.mp3","subtitle_url":"https://example.com/sub.ass"}'
+  -d '{"model":"ky-merge-video","video_file":"https://example.com/video.mp4","audio_file":"https://example.com/audio.mp3","subtitle_file":"https://example.com/sub.ass"}'
 ```

 **响应：**
@ -2109,14 +2109,14 @@ AI评估歌曲质量，返回多维度评分。

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `audio_url` | string | 是 | 音频文件URL |
+| `audio_file` | string | 是 | 音频文件URL |
 | `scene` | string | 否 | 场景类型，如 `pop`/`folk`/`rock`，默认 `pop` |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-songrate-evaluate","audio_url":"https://example.com/song.mp3","scene":"pop"}'
+  -d '{"model":"ky-songrate-evaluate","audio_file":"https://example.com/song.mp3","scene":"pop"}'
 ```

 **响应：**
@ -2146,7 +2146,7 @@ AI歌声合成，提交后返回任务ID，需轮询状态。
 |------|------|------|------|
 | `lyrics` | string | 是 | 歌词文本 |
 | `style` | string | 否 | 演唱风格，默认 `pop` |
-| `reference_audio` | string | 否 | 参考音频URL（用于声音克隆） |
+| `audio_file` | string | 否 | 参考音频URL（用于声音克隆） |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
@ -2202,14 +2202,14 @@ curl 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `image_url` | string | 是 | 图像URL |
+| `image_file` | string | 是 | 图像URL |
 | `scale` | integer | 否 | 放大倍数，默认 2 |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-realesrgan-upscale","image_url":"https://example.com/photo.jpg","scale":4}'
+  -d '{"model":"ky-realesrgan-upscale","image_file":"https://example.com/photo.jpg","scale":4}'
 ```

 **完成响应：**
@ -2248,14 +2248,14 @@ curl 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `audio_url` | string | 是 | 输入音频URL |
+| `audio_file` | string | 是 | 输入音频URL |
 | `voice_model` | string | 是 | 目标声音模型名 |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-rvc-convert","audio_url":"https://example.com/input.wav","voice_model":"singer_a"}'
+  -d '{"model":"ky-rvc-convert","audio_file":"https://example.com/input.wav","voice_model":"singer_a"}'
 ```

 **响应：**
@ -2277,13 +2277,13 @@ curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \

 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `video_url` | string | 是 | 视频URL |
+| `video_file` | string | 是 | 视频URL |

 ```bash
 curl -X POST 'https://token.opencomputing.cn/llmage/v1/pipeline/submit' \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
-  -d '{"model":"ky-video-eval-evaluate","video_url":"https://example.com/video.mp4"}'
+  -d '{"model":"ky-video-eval-evaluate","video_file":"https://example.com/video.mp4"}'
 ```

 **响应：**