首页> 都市> KingFlow AI API中转站 PowerShell 7 接入教程

>

KingFlow AI API中转站 PowerShell 7 接入教程

著

本文标签:

KingFlow AI API中转站 PowerShell 7 接入教程 实现 JSON 请求 SSE 流式输出 超时 有限重试与取消 PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 JSON 请

来源:KingFlow AI   主角:   更新: 2026-11-18 15:36:19

在线阅读

【扫一扫】手机随心读

  • 读书简介

KingFlow AI API中转站 PowerShell 7 接入教程 实现 JSON 请求 SSE 流式输出 超时 有限重试与取消 PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 JSON 请

KingFlow AI API中转站 PowerShell 7 接入教程

KingFlow AI API中转站 PowerShell 7 接入教程

实现 **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,避免等待完整响应体后才返回。

PowerShell 7 调用 KingFlow AI

图 1 PowerShell 7 通过 Invoke RestMethod 调用 KingFlow AI

二 为什么适合自动化场景

  • PowerShell 对 **ON、环境变量、文件和管道有直接支持。
  • Invoke-RestMethod 会把 **ON 响应转换为对象,适合普通请求。
  • .NET Http****** 可以按响应行读取 SSE,并使用取消令牌控制总时长。
  • 函数、模块和脚本参数便于在运维流程中复用。
  • Windows、Linux 和 **cOS 上的 PowerShell 7 可以采用相同的核心代码。

本文的流式代码面向 PowerShell 7.4 或更高版本,因为它使用带取消令牌的异步读取。普通请求部分可用于较早的 PowerShell 7;如果没有 OperationTimeoutSeconds 参数,可改用 TimeoutSec 或统一使用 Http******。

三 准备 PowerShell 与环境变量

先确认正在使用 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 保存状态码,重试函数不需要解析异常文本。

六 创建普通 **ON 请求函数

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 和其他字段。

八 用 Http****** 读取 SSE

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 是活动并行任务的上限。子运行空间会继承进程环境变量,但不会自动继承当前会话中的函数,因此把函数放入脚本或模块更稳定。

PowerShell 客户端稳定性设计

图 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 总时长

十四 上线前检查

  • ☐ 密钥来自环境变量、CI 密钥或密钥管理系统。
  • ☐ 日志不包含 Authorization、完整敏感提示词和完整响应。
  • ☐ **ON 和 SSE 请求都检查状态码并保留脱敏错误信息。
  • ☐ 重试只覆盖临时故障,次数、退避和总耗时都有上限。
  • ☐ 流式请求有 CancellationToken 控制总时长。
  • ☐ 并行任务使用 ThrottleLimit,且按业务优先级分配额度。
  • ☐ 记录模型、状态码、耗时、首字延迟、重试次数和 token 用量。
  • ☐ 已完成小流量验证、故障演练和回滚准备。

结语

PowerShell 7 可以用较少代码完成 API中转调用。普通 **ON 请求使用 Invoke-RestMethod,SSE 使用 Http****** 和 ResponseHeadersRead,稳定性由超时、有限重试、取消、并发限制和指标共同保障。先用最小请求确认 KingFlow AI 的密钥与模型,再把函数整理为模块,适合持续集成和运维自动化复用。

《KingFlow AI API中转站 PowerShell 7 接入教程》资讯列表: