DeepInfra Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: DeepInfra

개요

이 페이지는 OpenClaw DeepInfra provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use DeepInfra's unified API to access the most popular open source and frontier models in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Surface	Default model	OpenClaw config/tool
Chat / model provider	`deepseek-ai/DeepSeek-V4-Flash` (live catalog adds more chat models)	`agents.defaults.model`
Image generation/editing	`black-forest-labs/FLUX-1-schnell` (live catalog adds more `image-gen` models)	`image_generate`, `agents.defaults.mediaModels.image`
Media understanding	`moonshotai/Kimi-K2.5` for images	inbound image understanding
Speech-to-text	`openai/whisper-large-v3-turbo`	inbound audio transcription
Text-to-speech	`hexgrad/Kokoro-82M`	`tts.provider: "deepinfra"`
Video generation	`Pixverse/Pixverse-T2V` (live catalog adds more `video-gen` models)	`video_generate`, `agents.defaults.mediaModels.video`
Memory embeddings	`BAAI/bge-m3`	`memory.search.provider: "deepinfra"`

공식 문서 기반 상세

아래는 공식 providers/deepinfra 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

DeepInfra routes requests to popular open source and frontier models behind a single OpenAI-compatible endpoint and API key. Most OpenAI SDKs work against it by switching the base URL.

Install plugin

openclaw plugins install @openclaw/deepinfra-provider
openclaw gateway restart

Get an API key

Sign in at deepinfra.com
Go to Dashboard / Keys and generate a key, or use the auto-created one

CLI setup

openclaw onboard --deepinfra-api-key <key>

Or set the environment variable:

export DEEPINFRA_API_KEY="<your-deepinfra-api-key>" # pragma: allowlist secret

Config snippet

{
  env: { DEEPINFRA_API_KEY: "<your-deepinfra-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "deepinfra/deepseek-ai/DeepSeek-V4-Flash" },
    },
  },
}

Supported surfaces

Chat, image generation, and video generation refresh their model catalogs live from https://api.deepinfra.com/v1/openai/models?sort_by=openclaw&filter=with_meta once DEEPINFRA_API_KEY is configured. Live discovery expands the list of selectable models; the default model per surface stays the static value below. Other surfaces use static catalogs until they move onto the same live catalog.

Surface	Default model	OpenClaw config/tool
Chat / model provider	`deepseek-ai/DeepSeek-V4-Flash` (live catalog adds more chat models)	`agents.defaults.model`
Image generation/editing	`black-forest-labs/FLUX-1-schnell` (live catalog adds more `image-gen` models)	`image_generate`, `agents.defaults.mediaModels.image`
Media understanding	`moonshotai/Kimi-K2.5` for images	inbound image understanding
Speech-to-text	`openai/whisper-large-v3-turbo`	inbound audio transcription
Text-to-speech	`hexgrad/Kokoro-82M`	`tts.provider: "deepinfra"`
Video generation	`Pixverse/Pixverse-T2V` (live catalog adds more `video-gen` models)	`video_generate`, `agents.defaults.mediaModels.video`
Memory embeddings	`BAAI/bge-m3`	`memory.search.provider: "deepinfra"`

DeepInfra also exposes reranking, classification, object-detection, and other native model types. OpenClaw has no provider contract for those categories yet, so this plugin does not register them.

Available models

OpenClaw discovers DeepInfra models dynamically once a key is configured. Use /models deepinfra or openclaw models list --provider deepinfra to see the current list.

Any model on deepinfra.com works with the deepinfra/ prefix:

deepinfra/deepseek-ai/DeepSeek-V4-Flash
deepinfra/deepseek-ai/DeepSeek-V3.2
deepinfra/MiniMaxAI/MiniMax-M2.5
deepinfra/moonshotai/Kimi-K2.5
deepinfra/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B
deepinfra/zai-org/GLM-5.1
...and many more

참고

Model refs are deepinfra/<provider>/<model> (for example deepinfra/Qwen/Qwen3-Max).
Default chat model: deepinfra/deepseek-ai/DeepSeek-V4-Flash
Base URL: https://api.deepinfra.com/v1/openai
Video generation uses the OpenAI-compatible async endpoint https://api.deepinfra.com/v1/openai/videos (submit, then poll). A configured baseUrl is honored. openclaw doctor --fix migrates legacy nativeBaseUrl or /v1/inference values on api.deepinfra.com to baseUrl automatically; custom native endpoints are retired with a doctor notice and need a manually configured OpenAI-compatible baseUrl. Video generation fails with an actionable error (before sending any request) while baseUrl still targets the retired /v1/inference surface.

검증 체크리스트

openclaw models list --provider deepinfra 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

DeepInfra Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: DeepInfra

개요

이 페이지는 OpenClaw DeepInfra provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use DeepInfra's unified API to access the most popular open source and frontier models in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Surface	Default model	OpenClaw config/tool
Chat / model provider	`deepseek-ai/DeepSeek-V4-Flash` (live catalog adds more chat models)	`agents.defaults.model`
Image generation/editing	`black-forest-labs/FLUX-1-schnell` (live catalog adds more `image-gen` models)	`image_generate`, `agents.defaults.mediaModels.image`
Media understanding	`moonshotai/Kimi-K2.5` for images	inbound image understanding
Speech-to-text	`openai/whisper-large-v3-turbo`	inbound audio transcription
Text-to-speech	`hexgrad/Kokoro-82M`	`tts.provider: "deepinfra"`
Video generation	`Pixverse/Pixverse-T2V` (live catalog adds more `video-gen` models)	`video_generate`, `agents.defaults.mediaModels.video`
Memory embeddings	`BAAI/bge-m3`	`memory.search.provider: "deepinfra"`

공식 문서 기반 상세

DeepInfra routes requests to popular open source and frontier models behind a single OpenAI-compatible endpoint and API key. Most OpenAI SDKs work against it by switching the base URL.

Install plugin

openclaw plugins install @openclaw/deepinfra-provider
openclaw gateway restart

Get an API key

Sign in at deepinfra.com
Go to Dashboard / Keys and generate a key, or use the auto-created one

CLI setup

openclaw onboard --deepinfra-api-key <key>

Or set the environment variable:

export DEEPINFRA_API_KEY="<your-deepinfra-api-key>" # pragma: allowlist secret

Config snippet

{
  env: { DEEPINFRA_API_KEY: "<your-deepinfra-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "deepinfra/deepseek-ai/DeepSeek-V4-Flash" },
    },
  },
}

Supported surfaces

Surface	Default model	OpenClaw config/tool
Chat / model provider	`deepseek-ai/DeepSeek-V4-Flash` (live catalog adds more chat models)	`agents.defaults.model`
Image generation/editing	`black-forest-labs/FLUX-1-schnell` (live catalog adds more `image-gen` models)	`image_generate`, `agents.defaults.mediaModels.image`
Media understanding	`moonshotai/Kimi-K2.5` for images	inbound image understanding
Speech-to-text	`openai/whisper-large-v3-turbo`	inbound audio transcription
Text-to-speech	`hexgrad/Kokoro-82M`	`tts.provider: "deepinfra"`
Video generation	`Pixverse/Pixverse-T2V` (live catalog adds more `video-gen` models)	`video_generate`, `agents.defaults.mediaModels.video`
Memory embeddings	`BAAI/bge-m3`	`memory.search.provider: "deepinfra"`

DeepInfra also exposes reranking, classification, object-detection, and other native model types. OpenClaw has no provider contract for those categories yet, so this plugin does not register them.

Available models

OpenClaw discovers DeepInfra models dynamically once a key is configured. Use /models deepinfra or openclaw models list --provider deepinfra to see the current list.

Any model on deepinfra.com works with the deepinfra/ prefix:

deepinfra/deepseek-ai/DeepSeek-V4-Flash
deepinfra/deepseek-ai/DeepSeek-V3.2
deepinfra/MiniMaxAI/MiniMax-M2.5
deepinfra/moonshotai/Kimi-K2.5
deepinfra/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B
deepinfra/zai-org/GLM-5.1
...and many more

참고

Model refs are deepinfra/<provider>/<model> (for example deepinfra/Qwen/Qwen3-Max).
Default chat model: deepinfra/deepseek-ai/DeepSeek-V4-Flash
Base URL: https://api.deepinfra.com/v1/openai
Video generation uses the OpenAI-compatible async endpoint https://api.deepinfra.com/v1/openai/videos (submit, then poll). A configured baseUrl is honored. openclaw doctor --fix migrates legacy nativeBaseUrl or /v1/inference values on api.deepinfra.com to baseUrl automatically; custom native endpoints are retired with a doctor notice and need a manually configured OpenAI-compatible baseUrl. Video generation fails with an actionable error (before sending any request) while baseUrl still targets the retired /v1/inference surface.

검증 체크리스트

openclaw models list --provider deepinfra 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

DeepInfra Provider

개요

빠른 참조

공식 문서 기반 상세

Install plugin

Get an API key

CLI setup

Config snippet

Supported surfaces

Available models

참고

관련 문서

검증 체크리스트

관련

관련 가이드

DeepInfra Provider

개요

빠른 참조

공식 문서 기반 상세

Install plugin

Get an API key

CLI setup

Config snippet

Supported surfaces

Available models

참고

관련 문서

검증 체크리스트

관련

관련 가이드