---
title: "BroadNet Inference 指南：SDK、智能体与阿拉伯语语音 | BroadRouter"
description: "分步指南：配置 OpenAI SDK、流式输出、在无限量套餐上运行编程智能体、阿拉伯语转写、图像理解，以及错误处理与重试。"
url: https://broadrouter.com/zh/guides/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

这些页面由英文原文借助 AI 翻译。 [全部英文指南](https://broadrouter.com/guides/) (46).

# 指南

更新于 2026-11-16

每篇指南解决一项任务，并附上可以直接在 BroadNet Inference 的 OpenAI 兼容 API 上运行的代码。先从你使用的 SDK 开始，再按用途选择指南。每篇指南都列出来源和核实日期。

## 入门

1.  [https://broadrouter.com/zh/guides/openai-python-sdk/](https://broadrouter.com/zh/guides/openai-python-sdk/)
    
    ### [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)
    
    只改一个 base\_url，就能让官方 OpenAI Python SDK 调用 BroadNet Inference：安装、设置密钥、发出第一个请求，再把回答改成流式输出。
    
2.  [https://broadrouter.com/zh/guides/openai-node-sdk/](https://broadrouter.com/zh/guides/openai-node-sdk/)
    
    ### [用 OpenAI Node.js SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-node-sdk/)
    
    设置 baseURL，让官方 OpenAI Node.js / TypeScript SDK 调用 BroadNet Inference：安装、发出第一个请求、流式输出 token，并记录请求 ID。
    
3.  [https://broadrouter.com/zh/guides/try-broadnet-inference-playground/](https://broadrouter.com/zh/guides/try-broadnet-inference-playground/)
    
    ### [免注册，在浏览器里试用 BroadNet Inference](https://broadrouter.com/zh/guides/try-broadnet-inference-playground/)
    
    在 BroadNet 的浏览器 Playground 里免注册、免绑卡测试阿拉伯语语音转文字、文档识别和 Gemma 4 对话，再把同样的请求搬到 API 上。
    
4.  [https://broadrouter.com/zh/guides/curl-quickstart/](https://broadrouter.com/zh/guides/curl-quickstart/)
    
    ### [用 curl 首次调用 BroadNet Inference API](https://broadrouter.com/zh/guides/curl-quickstart/)
    
    用 curl 完成对 BroadNet Inference 的首次调用：一次对话补全、一次流式输出和一次音频转写，并学会读懂响应、usage 和错误。
    

## 智能体与套餐

1.  [https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
    
    ### [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
    
    不限量 DeepSeek V4.1 Flash 套餐没有 token 计量，也没有每周限额。本文说明会话、并行智能体、密钥和计费的实际运作方式。
    

## 阿拉伯语与语音

1.  [https://broadrouter.com/zh/guides/arabic-speech-to-text-api/](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)
    
    ### [阿拉伯语语音转文字 API 分步教程](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)
    
    通过 OpenAI 兼容端点，用 BroadNet Transcribe Arabic 转写阿拉伯语音频：支持的格式、language 字段、Python 和 curl 示例，以及价格。
    
2.  [https://broadrouter.com/zh/guides/transcribe-whatsapp-voice-notes/](https://broadrouter.com/zh/guides/transcribe-whatsapp-voice-notes/)
    
    ### [用 API 把 WhatsApp 语音消息转成文字](https://broadrouter.com/zh/guides/transcribe-whatsapp-voice-notes/)
    
    用 ffmpeg 把 WhatsApp 的 .ogg 语音消息或手机的 .m4a 录音转成 WAV，再用一次 API 调用转写成阿拉伯语或其他 13 种语言的文字。
    
3.  [https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/](https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/)
    
    ### [用视觉模型识别阿拉伯语发票和收据](https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/)
    
    把发票或收据照片发给 BroadNet Inference 上的视觉模型，用阿拉伯语或英语提问，以 JSON 形式拿回总金额、日期和商家。
    

## 集成

-   [用不限量的 DeepSeek V4.1 Flash 运行 Aider](https://broadrouter.com/zh/guides/aider-unlimited-deepseek/)
    
    通过 Aider 的 OpenAI 兼容设置把这款编程智能体接到 BroadNet Inference，在固定价格、不限量的 DeepSeek V4.1 Flash 套餐上运行。
    
-   [在 LangChain 中调用 BroadNet Inference](https://broadrouter.com/zh/guides/langchain-openai-base-url/)
    
    用 base\_url 和 api\_key 把 LangChain 的 ChatOpenAI 接到 BroadNet Inference，并了解 LangChain 会保留和丢弃思考模型的哪些字段。
    
-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
    
    通过 OpenAI Compatible 提供商把 VS Code 插件 Cline 接到 BroadNet Inference：每个字段怎么填、模型 ID、上下文大小和常见问题的解决办法。
    
-   [在 Roo Code 中使用 BroadNet Inference（OpenAI Compatible）](https://broadrouter.com/zh/guides/roo-code-openai-compatible/)
    
    Roo Code 已于 2026 年 5 月停止维护。本文给出现有安装和分支版本的配置方法，以及接下来该迁移到哪里（Cline 或 Zoo Code 分支），并接入 BroadNet Inference。
    
-   [在 Continue 中使用 BroadNet Inference（config.yaml 与 apiBase）](https://broadrouter.com/zh/guides/continue-dev-openai-compatible/)
    
    在 config.yaml 中用 provider openai 和 apiBase 把 BroadNet Inference 模型加入 Continue IDE 插件，包括 tool\_use 能力和上下文长度。
    
-   [把 BroadNet Inference 添加为 opencode 的自定义供应商](https://broadrouter.com/zh/guides/opencode-custom-provider/)
    
    在 opencode.jsonc 中把 BroadNet Inference 添加为 opencode 编程 agent 的自定义 OpenAI 兼容供应商，并设置模型别名、能力和限制。
    
-   [把 Open WebUI 接入 BroadNet Inference](https://broadrouter.com/zh/guides/open-webui-openai-api/)
    
    在 Open WebUI 中把 BroadNet Inference 添加为 OpenAI 兼容连接，把模型 ID 加入白名单，并解决连接验证失败、空回复和速率限制问题。
    
-   [把 BroadNet Inference 作为自定义端点添加到 LibreChat](https://broadrouter.com/zh/guides/librechat-custom-endpoint/)
    
    在 librechat.yaml 中把 BroadNet Inference 添加为 LibreChat 的 OpenAI 兼容自定义端点：密钥放在 .env，配置模型列表、标题模型，以及常见问题的解决办法。
    
-   [在 n8n 中使用 BroadNet Inference（OpenAI 凭据与 Base URL）](https://broadrouter.com/zh/guides/n8n-openai-compatible/)
    
    在 n8n 的 OpenAI 凭据里用 Base URL 字段指向 BroadNet Inference，再在 OpenAI Chat Model 节点中按 ID 选模型，并关闭 Responses API 开关。
    
-   [用 Vercel AI SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/vercel-ai-sdk-openai-compatible/)
    
    用 @ai-sdk/openai-compatible 的 createOpenAICompatible 从 Vercel AI SDK 调用 BroadNet Inference：generateText、streamText、工具和思考强度。
    
-   [用 LiteLLM 路由到 BroadNet Inference（SDK 与代理）](https://broadrouter.com/zh/guides/litellm-proxy-custom-provider/)
    
    在 LiteLLM 的 Python SDK 或代理 config.yaml 中，用 openai/ 模型前缀和 api\_base 调用 BroadNet Inference，并配好匹配的速率限制。
    
-   [在 BroadNet Inference 上运行 OpenAI Agents SDK](https://broadrouter.com/zh/guides/openai-agents-sdk-custom-provider/)
    
    通过 AsyncOpenAI 和 OpenAIChatCompletionsModel，让 Python 版 OpenAI Agents SDK 调用 BroadNet Inference，并关闭需要 OpenAI 密钥的 tracing。
    
-   [在 n8n 中转写 WhatsApp 语音消息](https://broadrouter.com/zh/guides/n8n-whatsapp-voice-note-transcription/)
    
    一个 n8n 工作流：接收 WhatsApp 语音消息，从 Meta 下载，用 ffmpeg 转换格式，再转写成阿拉伯语或其他 13 种语言的文字。
    
-   [在 Zed 中把 BroadNet Inference 配置为 OpenAI 兼容提供商](https://broadrouter.com/zh/guides/zed-openai-compatible-provider/)
    
    在 Zed 编辑器的 settings.json 中把 BroadNet Inference 添加为 OpenAI 兼容提供商，包括模型 ID、token 限制、能力开关和密钥环境变量。
    
-   [在 Kilo Code 中使用 BroadNet Inference（OpenAI Compatible 供应商）](https://broadrouter.com/zh/guides/kilo-code-openai-compatible/)
    
    把 Kilo Code 接到 BroadNet Inference，作为 OpenAI Compatible 自定义供应商：可在 VS Code 对话框或 kilo.json 中配置模型 ID、上限和工具开关。
    
-   [把 BroadNet Inference 作为自定义供应商接入 goose](https://broadrouter.com/zh/guides/goose-custom-provider/)
    
    把 goose AI agent 接到 BroadNet Inference，作为 OpenAI Compatible 自定义供应商：可以用 goose Desktop、goose configure 或 JSON 文件配置。
    
-   [在 BroadNet Inference 上使用 Pydantic AI（OpenAICompatibleProvider）](https://broadrouter.com/zh/guides/pydantic-ai-openai-compatible/)
    
    用 OpenAIChatModel 和 OpenAICompatibleProvider 在 BroadNet Inference 上运行 Pydantic AI agent，包括工具调用、结构化输出和模型 profile 的调整。
    
-   [在 CrewAI 中把 BroadNet Inference 用作自定义 OpenAI 端点](https://broadrouter.com/zh/guides/crewai-custom-openai-endpoint/)
    
    用 LLM(custom\_openai=True, base\_url=...) 把 CrewAI 智能体指向 BroadNet Inference，再按工具调用、长上下文和固定价格套餐选择模型。
    
-   [通过 OpenAILike 在 LlamaIndex 中使用 BroadNet Inference](https://broadrouter.com/zh/guides/llamaindex-openailike/)
    
    用 OpenAILike 类把 LlamaIndex 接入 BroadNet Inference，并正确设置 api\_base、context\_window、is\_chat\_model 和 is\_function\_calling\_model。
    
-   [用 OpenAI-API-compatible 插件把 BroadNet Inference 接入 Dify](https://broadrouter.com/zh/guides/dify-openai-api-compatible/)
    
    通过 OpenAI-API-compatible 模型供应商插件把 Dify 接到 BroadNet Inference：每个字段的准确取值、上下文大小和函数调用设置。
    
-   [在 Jan 中把 BroadNet Inference 添加为 OpenAI 兼容的自定义供应商](https://broadrouter.com/zh/guides/jan-custom-endpoint/)
    
    在 Jan 桌面应用中把 BroadNet Inference 添加为 OpenAI 兼容的自定义供应商，手动添加模型 ID，并为每个模型开启工具和视觉能力。
    
-   [把 SillyTavern 接入 BroadNet Inference（自定义 OpenAI 兼容端点）](https://broadrouter.com/zh/guides/sillytavern-custom-openai-endpoint/)
    
    用 Custom (OpenAI-compatible) 这个 Chat Completion 来源把 SillyTavern（酒馆）接入 BroadNet Inference，包括正确的模型 ID、提示词后处理和 token 上限。
    
-   [在 BroadNet Inference 上使用 Spring AI（OpenAI base-url）](https://broadrouter.com/zh/guides/spring-ai-openai-base-url/)
    
    用 spring.ai.openai.base-url、BroadNet 模型 ID 和 max-tokens 把 Spring AI 的 OpenAI chat starter 指向 BroadNet Inference，再通过 ChatClient 调用。
    
-   [用 Go 和 openai-go SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-go-sdk/)
    
    通过 option.WithBaseURL，用官方 openai-go v3 SDK 调用 BroadNet Inference：Go 里的对话补全、带用量统计的流式输出和错误处理。
    
-   [在 BroadNet Inference 上构建 LangGraph 智能体](https://broadrouter.com/zh/guides/langgraph-openai-compatible/)
    
    用 ChatOpenAI、base\_url 和 BroadNet 模型 ID 在 BroadNet Inference 上运行 LangGraph 的 StateGraph 或 create\_agent，并配置工具、流式输出和记忆。
    
-   [在 Haystack 的 pipeline 和 agent 中使用 BroadNet Inference](https://broadrouter.com/zh/guides/haystack-openai-compatible/)
    
    用 api\_base\_url、BroadNet 模型 ID 和 Secret 密钥，把 Haystack 的 OpenAIChatGenerator 指向 BroadNet Inference，支持 pipeline、工具、流式输出和 agent。
    
-   [在 BroadNet Inference 上使用 Semantic Kernel](https://broadrouter.com/zh/guides/semantic-kernel-openai-compatible/)
    
    把 Microsoft Semantic Kernel 接入 BroadNet Inference：Python 用 AsyncOpenAI 客户端，C# 用自定义端点，支持对话、插件和智能体。
    
-   [在 BroadNet Inference 上运行 Mastra 智能体](https://broadrouter.com/zh/guides/mastra-openai-compatible/)
    
    用一个设置了 id、url 和 apiKey 的 model 对象，在 BroadNet Inference 上运行 Mastra 智能体，并说明模型 ID 为什么要写两遍 broadnet/ 前缀。
    
-   [在 BroadNet Inference 上用 Instructor 获取结构化输出](https://broadrouter.com/zh/guides/instructor-structured-output/)
    
    用 Instructor 从 BroadNet Inference 提取 Pydantic 对象：通过 from\_openai 或 from\_provider 设置自定义 base\_url，并选对 Mode。
    
-   [在 DSPy 中使用 BroadNet Inference（设置 model\_type="chat"）](https://broadrouter.com/zh/guides/dspy-openai-compatible/)
    
    为 BroadNet Inference 配置 dspy.LM：使用 openai/ 前缀、api\_base 和 model\_type="chat"，因为 DSPy 3.5 会把 OpenAI 模型发到 Responses API。
    
-   [用 promptfoo 评测 BroadNet 的模型](https://broadrouter.com/zh/guides/promptfoo-openai-compatible/)
    
    用 openai:chat 供应商、apiBaseUrl 和 apiKeyEnvar，在 BroadNet Inference 上运行 promptfoo 评测和模型并排对比测试，并配置评分模型。
    
-   [用 OpenAIModel 在 BroadNet Inference 上运行 smolagents](https://broadrouter.com/zh/guides/smolagents-openai-compatible/)
    
    用 OpenAIModel 和 api\_base 把 Hugging Face smolagents 接入 BroadNet Inference：CodeAgent 可用任意模型，ToolCallingAgent 用 GLM 5.3 和 Qwen3.8 27B。
    
-   [把 Flowise 接入 BroadNet Inference（OpenAI Custom Model 节点）](https://broadrouter.com/zh/guides/flowise-openai-compatible/)
    
    在 Flowise chatflow 中用 OpenAI Custom Model 节点调用 BroadNet Inference：设置 Base Path、OpenAI API 凭证，并手动填写 BroadNet 模型名。
    
-   [在 Langflow 中接入 BroadNet Inference](https://broadrouter.com/zh/guides/langflow-openai-compatible/)
    
    在 Langflow 中通过 OpenAI 组件的 OpenAI API Base 字段和手动填写的模型名使用 BroadNet Inference，并说明为什么 OpenAI Compatible 服务商列不出它的模型。
    

要找的工具还没有指南？[查看所有集成 （英文）](https://broadrouter.com/integrations/)，了解每个工具的接入方式。

## 参考

1.  [https://broadrouter.com/zh/guides/streaming-chat-completions/](https://broadrouter.com/zh/guides/streaming-chat-completions/)
    
    ### [对话补全的流式输出，以及连接中断的处理](https://broadrouter.com/zh/guides/streaming-chat-completions/)
    
    BroadNet Inference 上的流式输出如何工作：Server-Sent Events（SSE）、\[DONE\] 结束标志、最后一个数据块里的 token 用量，以及流提前结束时该怎么做。
    
2.  [https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
    
    ### [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
    
    DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 会先思考再回答，思考内容计入 max\_tokens。本文说明如何避免收到空回复。
    
3.  [https://broadrouter.com/zh/guides/errors-and-retries/](https://broadrouter.com/zh/guides/errors-and-retries/)
    
    ### [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
    
    BroadNet Inference API 每个 HTTP 状态码的含义：哪些要指数退避重试，哪些要先修正请求，以及联系技术支持时要带上请求 ID 等哪些信息。
    
4.  [https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)
    
    ### [用 IP 白名单把 API 密钥锁定到你的服务器](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)
    
    用 IP 白名单保护 BroadNet Inference 密钥，把推理密钥和控制台凭证分开，并在几秒内吊销泄露的密钥。附 curl 示例。
    

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides&utm_content=page-cta) ·

**来源**

-   [API 参考 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides&utm_content=sources)
