大海小说网 > 都市 > KingFlow AI API中转站 PowerShell 7 接入教程
都市连载
KingFlow AI API中转站 PowerShell 7 接入教程 实现 JSON 请求 SSE 流式输出 超时 有限重试与取消 PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 JSON 请
主角: 更新:2026-11-18 15:36:26
扫描二维码手机上阅读
男女主角分别是的都市小说《KingFlow AI API中转站 PowerShell 7 接入教程》,由网络作家“佚名”所著,讲述一系列精彩纷呈的故事,本站纯净无弹窗,精彩内容欢迎阅读!小说详情介绍:KingFlow AI API中转站 PowerShell 7 接入教程 实现 JSON 请求 SSE 流式输出 超时 有限重试与取消 PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 JSON 请
实现 **ON 请求 SSE 流式输出 超时 有限重试与取消
PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 **ON 请求,再用 .NET Http****** 读取 SSE 流,并加入超时、有限重试、取消和日志。文中的 Claude中转、Claude中转站、API中转、API中转站都表示通过兼容协议转发模型请求的服务形态。实际模型、额度和计费以控制台为准。
| 术语 | 本文中的含义 |
|---|---|
| Claude中转 | 通过兼容接口发送 Claude 相关请求 |
| Claude中转站 | 提供密钥 模型 用量与通道管理的服务入口 |
| API中转 | 应用使用统一协议请求 再由服务端转发到模型 |
| API中转站 | 为多个脚本和项目集中管理鉴权 额度 日志与模型路由的平台 |
KingFlow AI 提供 OpenAI 和 Anthropic 双兼容接口。本文使用 OpenAI 兼容地址 https://api.**nju**shen.com/v1,请求路径为 /chat/completions。PowerShell 普通请求适合用 Invoke-RestMethod,SSE 流式响应则用 .NET Http****** 与 ResponseHeadersRead,避免等待完整响应体后才返回。

图 1 PowerShell 7 通过 Invoke RestMethod 调用 KingFlow AI
Invoke-RestMethod 会把 **ON 响应转换为对象,适合普通请求。Http****** 可以按响应行读取 SSE,并使用取消令牌控制总时长。本文的流式代码面向 PowerShell 7.4 或更高版本,因为它使用带取消令牌的异步读取。普通请求部分可用于较早的 PowerShell 7;如果没有 OperationTimeoutSeconds 参数,可改用 TimeoutSec 或统一使用 Http******。
先确认正在使用 PowerShell 7,而不是 Windows PowerShell 5.1:
$PSVersionTa*le.PSVersion
$PSVersionTa*le.PSEdition
在当前终端设置配置。模型 ID 必须替换为控制台中确实可用的值:
$env:KINGFLOW_API_KEY = 'sk-请替换'
$env:KINGFLOW_*ASE_**L = 'https://api.**nju**shen.com/v1'
$env:KINGFLOW_MODEL = '请替换为控制台可用模型'
环境变量只对当前进程及其子进程可见。长期运行的任务应从 CI/CD 密钥、Windows 凭据管理器或专用密钥系统注入,不要把密钥写进 .ps1、命令历史、截图或日志。
$headers = @{ Authorization = "*earer $env:KINGFLOW_API_KEY" }
$*ody = @{
model = $env:KINGFLOW_MODEL
messages = @(
@{ role = 'user'; content = '用一句话解释 PowerShell 管道' }
)
stream = $false
} | ConvertTo-Json -Depth 6 -Compress
$result = Invoke-RestMethod `
-Uri "$env:KINGFLOW_*ASE_**L/chat/completions" `
-Method Post `
-Headers $headers `
-ContentType 'application/json; charset=utf-8' `
-*ody $*ody
$result.choices[0].message.content
ConvertTo-Json -Depth 6 可保留 messages 数组内的嵌套字段。默认深度不足时,复杂对象可能被截断或产生警告。首次验证只需确认域名、密钥、模型和响应结构正确。
Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'
function Get-KingFlowConfig {
foreach ($name in 'KINGFLOW_API_KEY', 'KINGFLOW_MODEL') {
if ([string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVaria*le($name))) {
throw "缺少环境变量 $name"
}
}
[pscustomo*ject]@{
ApiKey = $env:KINGFLOW_API_KEY
Model = $env:KINGFLOW_MODEL
*aseUrl = if ($env:KINGFLOW_*ASE_**L) {
$env:KINGFLOW_*ASE_**L.TrimEnd('/')
} else {
'https://api.**nju**shen.com/v1'
}
}
}
function New-KingFlowException {
param([int]$StatusCode, [string]$Message)
$exception = [******.Exception]::new("**** $StatusCode $Message")
$exception.Data['StatusCode'] = $StatusCode
$exception
}
Set-StrictMode 能尽早发现未初始化变量和错误属性名。脚本使用异常 Data 保存状态码,重试函数不需要解析异常文本。
function Invoke-KingFlowChat {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [string]$Prompt,
[int]$ConnectionTimeoutSeconds = 15,
[int]$OperationTimeoutSeconds = 90
)
$config = Get-KingFlowConfig
$payload = @{
model = $config.Model
messages = @(@{ role = 'user'; content = $Prompt })
stream = $false
} | ConvertTo-Json -Depth 6 -Compress
$params = @{
Uri = "$($config.*aseUrl)/chat/completions"
Method = 'Post'
Headers = @{ Authorization = "*earer $($config.ApiKey)" }
ContentType = 'application/json; charset=utf-8'
*ody = $payload
ConnectionTimeoutSeconds = $ConnectionTimeoutSeconds
OperationTimeoutSeconds = $OperationTimeoutSeconds
SkipHttpErrorCheck = $true
StatusCodeVaria*le = 'statusCode'
ResponseHeadersVaria*le = 'responseHeaders'
}
$statusCode = 0
$watch = [******.Diagnosti**.Stopwatch]::StartNew()
try {
$response = Invoke-RestMethod @params
if ($statusCode -lt 200 -or $statusCode -ge 300) {
$message = $response | ConvertTo-Json -Depth 8 -Compress
throw (New-KingFlowException -StatusCode $statusCode -Message $message)
}
$text = $response.choices[0].message.content
if ([string]::IsNullOrWhiteSpace($text)) {
throw '响应中没有可用文本'
}
$text
}
finally {
$watch.Stop()
Write-Infor**tion "chat/completions ${statusCode} $($watch.ElapsedMilliseconds)ms"
}
}
SkipHttpErrorCheck 让 4xx 和 5xx 响应继续进入管道,脚本可以读取状态码和错误体。日志只记录路径、状态码与耗时,不记录 Authorization、完整提示词或完整回答。
$answer = Invoke-KingFlowChat `
-Prompt '用三点说明 PowerShell 7 适合自动化的原因' `
-Infor**tionAction Continue
$answer
普通请求适合批量总结、分类、结构化提取和无需逐字显示的**任务。若业务需要完整返回对象,可让函数输出 response,再由调用方读取 usage、finish_reason 和其他字段。
function Invoke-KingFlowStream {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [string]$Prompt,
[TimeSpan]$TotalTimeout = ([TimeSpan]::FromMinutes(3))
)
$config = Get-KingFlowConfig
$client = [******.Net.Http.Http******]::new()
$client.Timeout = [******.Threading.Timeout]::InfiniteTimeSpan
$cts = [******.Threading.CancellationTokenSource]::new($TotalTimeout)
$request = [******.Net.Http.HttpRequestMessage]::new(
[******.Net.Http.HttpMethod]::Post,
"$($config.*aseUrl)/chat/completions"
)
$response = $null
$stream = $null
$reader = $null
try {
$request.Headers.Authorization =
[******.Net.Http.Headers.AuthenticationHeaderValue]::new('*earer', $config.ApiKey)
$request.Headers.Accept.ParseAdd('text/event-stream')
$payload = @{
model = $config.Model
messages = @(@{ role = 'user'; content = $Prompt })
stream = $true
} | ConvertTo-Json -Depth 6 -Compress
$request.Content = [******.Net.Http.StringContent]::new(
$payload,
[******.Text.Encoding]::UTF8,
'application/json'
)
$response = $client.SendAsync(
$request,
[******.Net.Http.HttpCompletionOption]::ResponseHeadersRead,
$cts.Token
).GetAwaiter().GetResult()
if (-not $response.IsSuccessStatusCode) {
$error*ody = $response.Content.ReadAsStringAsync($cts.Token).GetAwaiter().GetResult()
throw (New-KingFlowException -StatusCode ([int]$response.StatusCode) -Message $error*ody)
}
$stream = $response.Content.ReadAsStreamAsync($cts.Token).GetAwaiter().GetResult()
$reader = [******.IO.StreamReader]::new($stream, [******.Text.Encoding]::UTF8)
$**taLines = [******.Collections.Generic.List[string]]::new()
while (($line = $reader.ReadLineAsync($cts.Token).GetAwaiter().GetResult()) -ne $null) {
if ($line.Length -eq 0) {
$**ta = $**taLines -join "`n"
$**taLines.Clear()
if ($**ta -eq '[DONE]') { *reak }
if ($**ta.Length -eq 0) { continue }
$chunk = $**ta | ConvertFrom-Json
$token = $chunk.choices[0].delta.content
if ($null -ne $token) { Write-Host -NoNewline $token }
}
elseif ($line.StartsWith('**ta:')) {
$**taLines.Add($line.Su*string(5).TrimStart())
}
}
Write-Host
}
finally {
if ($reader) { $reader.Dispose() }
if ($stream) { $stream.Dispose() }
if ($response) { $response.Dispose() }
$request.Dispose()
$cts.Dispose()
$client.Dispose()
}
}
ResponseHeadersRead 在收到响应头后立即返回,正文由脚本继续读取。Http****** 的 Timeout 在这种模式下只覆盖收到响应头之前的阶段,因此代码使用 CancellationTokenSource 控制整个流的总时长。SSE 事件以空行结束,一个事件可包含多条 **ta: 行。
Invoke-KingFlowStream -Prompt '用四句话介绍 PowerShell 7 的跨平台能力'
用户按 Ctrl C 会停止当前管道。嵌入更大的脚本时,也可以把 CancellationTokenSource 提升到调用层,在任务取消、作业终止或业务截止时间到达时调用 Cancel()。
function Invoke-WithRetry {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [script*lock]$Operation,
[Vali**teRange(1, 5)] [int]$MaxAttempts = 3
)
for ($attempt = 1; $attempt -le $MaxAttempts; $attempt ) {
try {
return & $Operation
}
catch {
$statusCode = $_.Exception.Data['StatusCode']
$retrya*le = $statusCode -eq 429 -or $statusCode -eq 503 -or
($statusCode -ge 500 -and $statusCode -le 599) -or
$null -eq $statusCode
if (-not $retrya*le -or $attempt -eq $MaxAttempts) { throw }
$*aseMs = 500 * [**th]::Pow(2, $attempt - 1)
$jitterMs = Get-Random -Minimum 0 -Ma**mum 250
Start-Sleep -Milliseconds ([int]($*aseMs $jitterMs))
}
}
}
$answer = Invoke-WithRetry {
Invoke-KingFlowChat -Prompt '生成一份简短的部署检查表'
}
只重试临时故障,并限制次数与总等待时间。401、403、404 与大多数 400 错误需要修正密钥、权限、模型或参数。SSE 已经输出 token 后不应自动从头重试,否则界面会出现重复文本。
$prompts = @(
'总结第一段日志'
'总结第二段日志'
'总结第三段日志'
'总结**段日志'
)
$scriptPath = Join-Path $PSScriptRoot 'Invoke-OnePrompt.ps1'
$results = $prompts | ForEach-O*ject -Parallel {
& $using:scriptPath -Prompt $_
} -ThrottleLimit 3
$results
把单次调用封装到 Invoke-OnePrompt.ps1 后,可用 ForEach-O*ject -Parallel 建立受控工作池。ThrottleLimit 是活动并行任务的上限。子运行空间会继承进程环境变量,但不会自动继承当前会话中的函数,因此把函数放入脚本或模块更稳定。

图 2 **ON SSE 超时 重试 取消和指标共同组成稳定的 PowerShell 客户端
建议把配置、普通请求、流式请求和重试函数保存为 KingFlow******.psm1,并在清单中只导出公开函数。模块加载时不要发送请求,也不要读取并打印密钥。脚本入口只负责解析参数、调用函数和设置退出码。
Export-ModuleMem*er -Function @(
'Invoke-KingFlowChat'
'Invoke-KingFlowStream'
'Invoke-WithRetry'
)
导入后运行 Get-Com**nd -Module KingFlow****** 检查公开命令。CI 中可以先执行 PSScriptAnalyzer,再用测试密钥完成小额连通性测试。
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 401 或 403 | 密钥 权限 Authorization | 确认 *earer 前缀 检查密钥状态且不要记录密钥 |
| 404 | *ase **L 路径 模型 | *ase **L 使用 /v1 路径使用 /chat/completions |
| 429 | 速率或额度 | 降低并发 使用有限退避 检查账户额度 |
| 503 | 通道暂不可用 | 短暂退避后少量重试 持续失败时告警 |
| **ON 字段丢失 | ConvertTo Json 深度 | 增大 Depth 并检查生成的请求体 |
| 流式无增量 | stream 参数 SSE 边界 **缓冲 | 设置 stream 为 true 并按空行组装事件 |
| 请求卡住 | 响应头超时 正文总时长 | 分别设置连接阶段和 CancellationToken 总时长 |
PowerShell 7 可以用较少代码完成 API中转调用。普通 **ON 请求使用 Invoke-RestMethod,SSE 使用 Http****** 和 ResponseHeadersRead,稳定性由超时、有限重试、取消、并发限制和指标共同保障。先用最小请求确认 KingFlow AI 的密钥与模型,再把函数整理为模块,适合持续集成和运维自动化复用。