---
title: "BroadNet Inference 가이드: SDK, 에이전트, 아랍어 음성 | BroadRouter"
description: "BroadNet Inference 단계별 가이드: OpenAI SDK 설정, 스트리밍, 무제한 플랜의 코딩 에이전트, 아랍어 음성 인식, 비전, 오류와 재시도."
url: https://broadrouter.com/ko/guides/
lang: ko
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/ko/guides/openai-python-sdk/](https://broadrouter.com/ko/guides/openai-python-sdk/)
    
    ### [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/)
    
    공식 OpenAI Python SDK에서 base\_url 하나만 바꿔 BroadNet Inference에 연결합니다. 설치, 키 설정, 첫 요청, 응답 스트리밍까지 순서대로 안내합니다.
    
2.  [https://broadrouter.com/ko/guides/openai-node-sdk/](https://broadrouter.com/ko/guides/openai-node-sdk/)
    
    ### [BroadNet Inference에서 OpenAI Node.js SDK 사용하기](https://broadrouter.com/ko/guides/openai-node-sdk/)
    
    공식 OpenAI Node.js·TypeScript SDK의 baseURL을 BroadNet Inference로 지정합니다. 설치, 첫 요청, 토큰 스트리밍, 요청 ID 로깅까지 안내합니다.
    
3.  [https://broadrouter.com/ko/guides/try-broadnet-inference-playground/](https://broadrouter.com/ko/guides/try-broadnet-inference-playground/)
    
    ### [계정 없이 브라우저에서 BroadNet Inference 체험하기](https://broadrouter.com/ko/guides/try-broadnet-inference-playground/)
    
    BroadNet 브라우저 플레이그라운드에서 가입이나 카드 없이 아랍어 음성 인식, 문서 읽기, Gemma 4 채팅을 테스트하고, 같은 요청을 API로 옮기는 방법입니다.
    
4.  [https://broadrouter.com/ko/guides/curl-quickstart/](https://broadrouter.com/ko/guides/curl-quickstart/)
    
    ### [curl로 BroadNet Inference에 첫 요청 보내기](https://broadrouter.com/ko/guides/curl-quickstart/)
    
    curl로 BroadNet Inference를 처음 호출해 봅니다. 채팅 완성, 스트리밍 응답, 오디오 전사를 실행하고 응답, usage, 오류를 읽는 법까지 정리했습니다.
    

## 에이전트와 플랜

1.  [https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
    
    ### [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
    
    무제한 DeepSeek V4.1 Flash 플랜에는 토큰 계량도 주간 한도도 없습니다. 세션, 병렬 에이전트, 키, 결제가 실제로 어떻게 작동하는지 정리했습니다.
    

## 아랍어와 음성

1.  [https://broadrouter.com/ko/guides/arabic-speech-to-text-api/](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)
    
    ### [아랍어 음성 인식(STT) API 사용법: 단계별 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)
    
    OpenAI 호환 엔드포인트에서 BroadNet Transcribe Arabic으로 아랍어 오디오를 전사하는 방법입니다. 지원 형식, language 필드, Python과 curl 예제, 가격을 정리했습니다.
    
2.  [https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/](https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/)
    
    ### [API로 WhatsApp 음성 메시지를 텍스트로 전사하기](https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/)
    
    WhatsApp .ogg 음성 메시지나 휴대폰 .m4a 녹음을 ffmpeg로 WAV로 변환하고, API 호출 한 번으로 아랍어 또는 다른 13개 언어로 전사하는 방법입니다.
    
3.  [https://broadrouter.com/ko/guides/read-arabic-invoices-with-vision/](https://broadrouter.com/ko/guides/read-arabic-invoices-with-vision/)
    
    ### [비전 모델로 아랍어 인보이스와 영수증 읽기](https://broadrouter.com/ko/guides/read-arabic-invoices-with-vision/)
    
    인보이스나 영수증 사진을 BroadNet Inference의 비전 모델에 보내 합계, 날짜, 공급업체를 JSON으로 받습니다. 질문은 아랍어나 영어로 할 수 있습니다.
    

## 연동

-   [Aider를 무제한 DeepSeek V4.1 Flash로 실행하기](https://broadrouter.com/ko/guides/aider-unlimited-deepseek/)
    
    Aider 코딩 에이전트를 OpenAI 호환 설정으로 BroadNet Inference에 연결하고, 정액 요금의 무제한 DeepSeek V4.1 Flash 플랜으로 실행하는 방법을 설명합니다.
    
-   [BroadNet Inference에서 LangChain 사용하기](https://broadrouter.com/ko/guides/langchain-openai-base-url/)
    
    LangChain의 ChatOpenAI를 base\_url과 api\_key로 BroadNet Inference에 연결하고, 추론 모델의 응답 중 LangChain이 유지하는 것과 버리는 것을 알아봅니다.
    
-   [BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/cline-openai-compatible/)
    
    VS Code 확장 Cline을 OpenAI Compatible 제공자로 BroadNet Inference에 연결합니다. 입력할 필드, 모델 ID, 컨텍스트 크기, 자주 겪는 문제의 해결법을 정리했습니다.
    
-   [BroadNet Inference에서 Roo Code 사용하기(OpenAI Compatible)](https://broadrouter.com/ko/guides/roo-code-openai-compatible/)
    
    Roo Code는 2026년 5월에 서비스가 종료되었습니다. 기존 설치와 포크용 설정, 그리고 BroadNet Inference와 함께 옮겨 갈 곳(Cline 또는 Zoo Code 포크)을 정리했습니다.
    
-   [Continue에서 BroadNet Inference 쓰기(config.yaml과 apiBase)](https://broadrouter.com/ko/guides/continue-dev-openai-compatible/)
    
    Continue IDE 확장의 config.yaml에 provider openai와 apiBase로 BroadNet Inference 모델을 추가합니다. tool\_use capabilities와 컨텍스트 길이 설정도 다룹니다.
    
-   [opencode에 BroadNet Inference를 커스텀 제공자로 추가하기](https://broadrouter.com/ko/guides/opencode-custom-provider/)
    
    opencode.jsonc에서 BroadNet Inference를 opencode 코딩 에이전트의 커스텀 OpenAI 호환 제공자로 추가하고, 모델 별칭과 capabilities, limit을 설정합니다.
    
-   [Open WebUI를 BroadNet Inference에 연결하기](https://broadrouter.com/ko/guides/open-webui-openai-api/)
    
    BroadNet Inference를 Open WebUI에 OpenAI 호환 연결로 추가하고 모델 ID를 허용 목록에 넣는 방법, 연결 확인 실패·빈 응답·속도 제한 문제의 해결법을 정리했습니다.
    
-   [LibreChat에 BroadNet Inference를 커스텀 엔드포인트로 추가하기](https://broadrouter.com/ko/guides/librechat-custom-endpoint/)
    
    librechat.yaml에 BroadNet Inference를 OpenAI 호환 커스텀 엔드포인트로 추가하는 방법입니다. .env의 키, 모델 목록, 제목 모델, 문제 해결까지 다룹니다.
    
-   [n8n에서 BroadNet Inference 사용하기(OpenAI 자격 증명, Base URL)](https://broadrouter.com/ko/guides/n8n-openai-compatible/)
    
    n8n의 OpenAI 자격 증명에서 Base URL을 BroadNet Inference로 바꾸고, OpenAI Chat Model 노드에서 모델을 ID로 지정한 뒤 Responses API 토글을 끄는 방법입니다.
    
-   [BroadNet Inference에서 Vercel AI SDK 사용하기](https://broadrouter.com/ko/guides/vercel-ai-sdk-openai-compatible/)
    
    @ai-sdk/openai-compatible의 createOpenAICompatible로 Vercel AI SDK에서 BroadNet Inference를 호출합니다. generateText, streamText, 도구, reasoning effort까지 다룹니다.
    
-   [LiteLLM을 BroadNet Inference에 연결하기(SDK와 프록시)](https://broadrouter.com/ko/guides/litellm-proxy-custom-provider/)
    
    LiteLLM에서 openai/ 모델 접두사와 api\_base로 BroadNet Inference를 호출합니다. Python SDK와 프록시 config.yaml 설정, 키에 맞춘 속도 제한까지 다룹니다.
    
-   [BroadNet Inference에서 OpenAI Agents SDK 실행하기](https://broadrouter.com/ko/guides/openai-agents-sdk-custom-provider/)
    
    AsyncOpenAI와 OpenAIChatCompletionsModel로 OpenAI Agents SDK(Python)를 BroadNet Inference에 연결하고, OpenAI 키가 필요한 트레이싱을 끄는 방법을 설명합니다.
    
-   [n8n에서 WhatsApp 음성 메시지 전사하기](https://broadrouter.com/ko/guides/n8n-whatsapp-voice-note-transcription/)
    
    WhatsApp 음성 메시지를 받아 Meta에서 내려받고, ffmpeg로 변환한 뒤 아랍어나 다른 13개 언어로 전사하는 n8n 워크플로입니다.
    
-   [Zed에서 BroadNet Inference를 OpenAI 호환 제공자로 쓰기](https://broadrouter.com/ko/guides/zed-openai-compatible-provider/)
    
    Zed 에디터의 settings.json에 BroadNet Inference를 OpenAI 호환 제공자로 추가하는 방법입니다. 모델 ID, 토큰 한도, capabilities, 키 환경 변수를 정리했습니다.
    
-   [Kilo Code에서 BroadNet Inference 쓰기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/kilo-code-openai-compatible/)
    
    VS Code 대화 상자나 kilo.json으로 Kilo Code를 BroadNet Inference에 OpenAI Compatible 커스텀 제공자로 연결하고, 모델 ID, 한도, 도구 플래그를 설정합니다.
    
-   [goose에 BroadNet Inference를 커스텀 제공자로 추가하기](https://broadrouter.com/ko/guides/goose-custom-provider/)
    
    goose AI 에이전트를 BroadNet Inference에 OpenAI Compatible 커스텀 제공자로 연결합니다. goose Desktop, goose configure, JSON 파일 세 가지 방법을 다룹니다.
    
-   [BroadNet Inference에서 Pydantic AI 사용하기(OpenAICompatibleProvider)](https://broadrouter.com/ko/guides/pydantic-ai-openai-compatible/)
    
    OpenAIChatModel과 OpenAICompatibleProvider로 Pydantic AI 에이전트를 BroadNet Inference에서 실행하고, 도구 호출, 구조화된 출력, 모델 프로필 설정까지 다룹니다.
    
-   [CrewAI에서 BroadNet Inference를 커스텀 OpenAI 엔드포인트로 쓰기](https://broadrouter.com/ko/guides/crewai-custom-openai-endpoint/)
    
    LLM(custom\_openai=True, base\_url=...)으로 CrewAI 에이전트를 BroadNet Inference에 연결하고, 도구·긴 컨텍스트·정액 플랜에 맞는 모델을 고르는 방법을 설명합니다.
    
-   [OpenAILike로 LlamaIndex와 BroadNet Inference 연결하기](https://broadrouter.com/ko/guides/llamaindex-openailike/)
    
    OpenAILike 클래스로 LlamaIndex를 BroadNet Inference에 연결하고 api\_base, context\_window, is\_chat\_model, is\_function\_calling\_model을 올바르게 설정하는 방법입니다.
    
-   [OpenAI-API-compatible 플러그인으로 Dify에 BroadNet Inference 추가하기](https://broadrouter.com/ko/guides/dify-openai-api-compatible/)
    
    OpenAI-API-compatible 모델 제공자 플러그인으로 Dify를 BroadNet Inference에 연결합니다. 필드별 입력값, 컨텍스트 크기, 함수 호출 설정을 정리했습니다.
    
-   [Jan에서 BroadNet Inference를 OpenAI 호환 커스텀 제공자로 쓰기](https://broadrouter.com/ko/guides/jan-custom-endpoint/)
    
    Jan 데스크톱 앱에 BroadNet Inference를 OpenAI 호환 커스텀 제공자로 추가하고, 모델 ID를 직접 입력한 뒤 모델별로 도구와 비전을 켜는 방법입니다.
    
-   [SillyTavern을 BroadNet Inference에 연결하기(Custom OpenAI 호환)](https://broadrouter.com/ko/guides/sillytavern-custom-openai-endpoint/)
    
    SillyTavern의 Custom (OpenAI-compatible) Chat Completion 소스로 BroadNet Inference에 연결합니다. 올바른 모델 ID, 프롬프트 후처리, 토큰 한도까지 정리했습니다.
    
-   [BroadNet Inference에서 Spring AI 사용하기(OpenAI base-url)](https://broadrouter.com/ko/guides/spring-ai-openai-base-url/)
    
    Spring AI의 OpenAI 채팅 스타터를 spring.ai.openai.base-url, BroadNet 모델 ID, max-tokens로 BroadNet Inference에 연결하고 ChatClient로 호출합니다.
    
-   [openai-go SDK로 Go에서 BroadNet Inference 호출하기](https://broadrouter.com/ko/guides/openai-go-sdk/)
    
    공식 openai-go v3 SDK에서 option.WithBaseURL로 BroadNet Inference에 연결합니다. Go에서 chat completions, 사용량 포함 스트리밍, 오류 처리까지 다룹니다.
    
-   [BroadNet Inference로 LangGraph 에이전트 만들기](https://broadrouter.com/ko/guides/langgraph-openai-compatible/)
    
    ChatOpenAI, base\_url, BroadNet 모델 ID로 LangGraph StateGraph나 create\_agent를 BroadNet Inference에서 실행하는 방법과 도구, 스트리밍, 메모리 설정을 알아봅니다.
    
-   [Haystack 파이프라인과 에이전트를 BroadNet Inference로 실행하기](https://broadrouter.com/ko/guides/haystack-openai-compatible/)
    
    api\_base\_url, BroadNet 모델 ID, Secret 키로 Haystack의 OpenAIChatGenerator를 BroadNet Inference에 연결해 파이프라인, 도구, 스트리밍, 에이전트에 씁니다.
    
-   [BroadNet Inference에서 Semantic Kernel 사용하기](https://broadrouter.com/ko/guides/semantic-kernel-openai-compatible/)
    
    Microsoft Semantic Kernel을 Python에서는 AsyncOpenAI 클라이언트로, C#에서는 커스텀 엔드포인트로 BroadNet Inference에 연결해 채팅, 플러그인, 에이전트에 씁니다.
    
-   [BroadNet Inference에서 Mastra 에이전트 사용하기](https://broadrouter.com/ko/guides/mastra-openai-compatible/)
    
    id, url, apiKey를 지정한 model 객체로 Mastra 에이전트를 BroadNet Inference에서 실행하는 방법과, 모델 ID에 broadnet/ 접두사를 두 번 써야 하는 이유를 설명합니다.
    
-   [BroadNet Inference에서 Instructor로 구조화된 출력 받기](https://broadrouter.com/ko/guides/instructor-structured-output/)
    
    커스텀 base\_url과 from\_openai 또는 from\_provider로 Instructor를 BroadNet Inference에 연결해 Pydantic 객체를 추출하고, 알맞은 Mode를 고르는 방법입니다.
    
-   [DSPy에서 BroadNet Inference 쓰기(model\_type="chat" 설정)](https://broadrouter.com/ko/guides/dspy-openai-compatible/)
    
    DSPy 3.5는 OpenAI 모델을 Responses API로 보내므로, openai/ 접두사와 api\_base, model\_type="chat"으로 dspy.LM을 BroadNet Inference에 맞게 설정합니다.
    
-   [promptfoo로 BroadNet 모델 평가하기](https://broadrouter.com/ko/guides/promptfoo-openai-compatible/)
    
    openai:chat 제공자와 apiBaseUrl, apiKeyEnvar로 BroadNet Inference에서 promptfoo 평가와 모델 비교 테스트를 실행하고, 채점 모델까지 설정합니다.
    
-   [OpenAIModel로 BroadNet Inference에서 smolagents 실행하기](https://broadrouter.com/ko/guides/smolagents-openai-compatible/)
    
    Hugging Face smolagents를 OpenAIModel과 api\_base로 BroadNet Inference에 연결합니다. CodeAgent는 어떤 모델에서든, ToolCallingAgent는 GLM 5.3과 Qwen3.8 27B에서 씁니다.
    
-   [Flowise에 BroadNet Inference 연결하기(OpenAI Custom Model)](https://broadrouter.com/ko/guides/flowise-openai-compatible/)
    
    Flowise 챗플로우에서 OpenAI Custom Model 노드, Base Path, OpenAI API 자격 증명, 직접 입력한 BroadNet 모델 이름으로 BroadNet Inference를 쓰는 방법입니다.
    
-   [Langflow에 BroadNet Inference 연결하기](https://broadrouter.com/ko/guides/langflow-openai-compatible/)
    
    Langflow의 OpenAI 컴포넌트에서 OpenAI API Base 필드와 직접 입력한 모델 이름으로 BroadNet Inference를 쓰는 방법과, OpenAI Compatible 제공자 목록에 나타나지 않는 이유를 설명합니다.
    

아직 가이드가 없는 도구를 찾고 있다면 [모든 연동 보기 (영어)](https://broadrouter.com/integrations/). 각 도구의 연결 방법도 나와 있습니다.

## 레퍼런스

1.  [https://broadrouter.com/ko/guides/streaming-chat-completions/](https://broadrouter.com/ko/guides/streaming-chat-completions/)
    
    ### [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/)
    
    BroadNet Inference의 스트리밍 응답을 정리했습니다. Server-Sent Events 형식, \[DONE\] 마커, 마지막 청크의 토큰 사용량, 스트림이 중간에 끊겼을 때의 대처법을 다룹니다.
    
2.  [https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
    
    ### [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
    
    DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B는 답하기 전에 추론하며, 그 추론도 max\_tokens에 포함됩니다. 빈 응답이 오지 않게 하는 방법을 정리했습니다.
    
3.  [https://broadrouter.com/ko/guides/errors-and-retries/](https://broadrouter.com/ko/guides/errors-and-retries/)
    
    ### [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
    
    BroadNet Inference API의 HTTP 상태 코드별 의미, 백오프로 재시도할 오류와 먼저 고쳐야 할 오류, 요청 ID와 함께 지원팀에 보낼 정보를 정리했습니다.
    
4.  [https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)
    
    ### [IP 허용 목록으로 API 키를 내 서버에만 묶기](https://broadrouter.com/ko/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=ko-guides&utm_content=page-cta) ·

**출처**

-   [API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides&utm_content=sources)
