Search⌘K
Agent API › Getting Started › Models

Models

Available models for the BLACKBOX Agent API. Use these model IDs in the model field when creating tasks.

The Agent API supports two execution modes — Claude Agent (default) and Standard Chat — each with their own set of available models.

Agent Runtimes — Claude vs Codex

Within the Claude Agent mode (type: "claude"), the API runs your task on one of two agent runtimes, selected automatically from the model id:

Runtime SDK Wire protocol Used for
Claude Agent (default) @anthropic-ai/claude-agent-sdk Anthropic Messages (/v1/messages) Anthropic/Claude ids and all other providers
Codex Agent @openai/codex-sdk OpenAI Responses (/v1/responses) OpenAI/Codex ids

Selection rule — a model id runs on the Codex runtime when it contains codex, openai/, gpt-, or starts with o1/o3/o4; otherwise it runs on the Claude runtime.

Example model id Runtime
blackboxai/openai/gpt-5.3-codex Codex
blackboxai/openai/gpt-5.5 (and gpt-5.4, gpt-5.4-pro, gpt-5.4-nano) Codex
blackboxai/anthropic/claude-opus-4.6 / claude-sonnet-4.5 Claude
everything else (nemotron, minimax, glm, …) Claude

Both runtimes are fully managed — they run inside the same sandbox, expose the same task lifecycle and event stream, and are interchangeable from the caller's perspective. You normally don't pick the runtime directly; you pick the model and the runtime follows.

Explicit override — pass agent: "claude" or agent: "codex" to force a runtime regardless of the model id (e.g. agent: "codex" with a non-OpenAI model). Omit agent to auto-select from the model id (default: claude). The benchmark endpoint (POST /api/v1/benchmarks/runs) accepts the same agent field.

Claude Agent Models

Used when type: "claude" (the default). Pass these IDs in the model field of your request body. The agent runtime (Claude vs Codex) is auto-selected per the rule above.

Model Name Model ID Notes
Claude Sonnet 4.6 blackboxai/anthropic/claude-sonnet-4.6 Default — best balance of speed and capability
Blackbox Pro blackboxai/blackbox-pro Blackbox flagship agent model
Claude Opus 4.7 blackboxai/anthropic/claude-opus-4.7 Latest Opus generation
Claude Opus 4.6 blackboxai/anthropic/claude-opus-4.6 Most capable, slower
Claude Sonnet 4.5 blackboxai/anthropic/claude-sonnet-4.5 Previous Sonnet generation
Claude Haiku 4.5 blackboxai/anthropic/claude-haiku-4.5 Fast, lightweight Claude model
GPT-5.5 Pro blackboxai/openai/gpt-5.5-pro OpenAI top-tier Pro model
GPT-5.5 blackboxai/openai/gpt-5.5 OpenAI flagship
GPT-5.4 Pro blackboxai/openai/gpt-5.4-pro OpenAI high-capability model
GPT-5.4 blackboxai/openai/gpt-5.4 OpenAI general-purpose model
GPT-5.4 Nano blackboxai/openai/gpt-5.4-nano Compact, low-latency OpenAI model
GPT-5.3 Codex blackboxai/openai/gpt-5.3-codex OpenAI code-specialized model
Nemotron 3 Nano 30B A3B blackboxai/nvidia/nemotron-3-nano-30b-a3b NVIDIA Nemotron compact MoE
Nemotron Nano 12B v2 VL blackboxai/nvidia/nemotron-nano-12b-v2-vl NVIDIA Nemotron vision-language
Grok 4.3 blackboxai/x-ai/grok-4.3 xAI flagship
Grok 4.1 Fast (Non-Reasoning) blackboxai/x-ai/grok-4.1-fast-non-reasoning xAI fast non-reasoning model
Grok Build 0.1 blackboxai/x-ai/grok-build-0.1 xAI build-focused model
MiniMax M2.7 blackboxai/minimax/minimax-m2.7 Latest MiniMax flagship
MiniMax M2.5 blackboxai/minimax/minimax-m2.5 MiniMax previous flagship
Gemini 3.5 Flash blackboxai/google/gemini-3.5-flash Google Gemini fast multimodal
Gemini 3.1 Pro Preview blackboxai/google/gemini-3.1-pro-preview Google Gemini Pro preview
Gemini 3.1 Flash Lite blackboxai/google/gemini-3.1-flash-lite Google Gemini lightweight
Gemma 4 26B A4B IT blackboxai/google/gemma-4-26b-a4b-it Google Gemma instruction-tuned MoE
Kimi K2.6 blackboxai/moonshotai/kimi-k2.6 Moonshot AI flagship
Devstral 2 blackboxai/mistral/devstral-2 Mistral developer model
Ministral 8B blackboxai/mistral/ministral-8b Mistral compact 8B model
Ministral 3B blackboxai/mistral/ministral-3b Mistral compact 3B model
Pixtral Large blackboxai/mistral/pixtral-large Mistral large multimodal model
Pixtral 12B blackboxai/mistral/pixtral-12b Mistral multimodal model
Codestral blackboxai/mistral/codestral Mistral code-specialized model
Mistral Medium 3.5 blackboxai/mistral/mistral-medium-3.5 Mistral medium-tier model
Mistral Small blackboxai/mistral/mistral-small Mistral small general-purpose model
Mistral Nemo blackboxai/mistral/mistral-nemo Mistral Nemo model
Llama 3.2 3B blackboxai/meta/llama-3.2-3b Meta Llama compact
Llama 3.2 1B blackboxai/meta/llama-3.2-1b Meta Llama smallest
Llama 3.1 70B blackboxai/meta/llama-3.1-70b Meta Llama 3.1 large
Llama 3.1 8B blackboxai/meta/llama-3.1-8b Meta Llama 3.1
Morph v3 Large blackboxai/morph/morph-v3-large Morph large model
Morph v3 Fast blackboxai/morph/morph-v3-fast Morph fast model
Nova 2 Lite blackboxai/amazon/nova-2-lite Amazon Nova lightweight model
Nova Micro blackboxai/amazon/nova-micro Amazon Nova smallest model
DeepSeek V4 Flash blackboxai/deepseek/deepseek-v4-flash DeepSeek fast model
MiMo v2.5 Pro blackboxai/xiaomi/mimo-v2.5-pro Xiaomi MiMo flagship
MiMo v2.5 blackboxai/xiaomi/mimo-v2.5 Xiaomi MiMo base model
Qwen 3.7 Max blackboxai/alibaba/qwen3.7-max Alibaba Qwen next-gen flagship
Qwen 3.6 Max Preview blackboxai/alibaba/qwen3.6-max-preview Alibaba Qwen flagship preview
Qwen 3.6 Plus blackboxai/alibaba/qwen3.6-plus Alibaba Qwen Plus tier
Qwen 3.6 27B blackboxai/alibaba/qwen3.6-27b Alibaba Qwen mid-size
Qwen3 VL 235B A22B Instruct blackboxai/alibaba/qwen3-vl-235b-a22b-instruct Qwen3 vision-language MoE
Qwen3 Max Thinking blackboxai/alibaba/qwen3-max-thinking Qwen3 reasoning-focused
Qwen3 Max blackboxai/qwen3-max Qwen3 flagship
Qwen3 Coder blackboxai/qwen3-coder Qwen3 code-specialized
Qwen3 VL 235B A22B blackboxai/qwen3-vl-235b-a22b Qwen3 vision-language MoE
Qwen3 VL 32B blackboxai/qwen3-vl-32b Qwen3 vision-language 32B
GLM-5 blackboxai/z-ai/glm-5 Z.AI GLM flagship
GLM-5.1 blackboxai/z-ai/glm-5.1 Z.AI GLM next iteration
GLM-5V Turbo blackboxai/z-ai/glm-5v-turbo Z.AI GLM vision turbo
GLM-4.7 Flash blackboxai/z-ai/glm-4.7-flash Z.AI GLM fast model
Trinity Large Thinking blackboxai/arcee-ai/trinity-large-thinking Arcee reasoning model
KAT Coder Pro v2 blackboxai/kwaipilot/kat-coder-pro-v2 Kwaipilot code model

If you omit the model field, the API defaults to blackboxai/anthropic/claude-sonnet-4.6.

Example — Single Agent with Model Override

curl -X POST 'https://agent.blackbox.ai/api/v1/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "Refactor the auth module to use middleware",
    "model": "blackboxai/anthropic/claude-opus-4.7"
  }'

Standard Chat Models

Used when type: "standard". Pass these IDs in the model field.

Model Name Model ID Notes
Mistral Small mistral/mistral-small Default — fast, streaming, tool use
MiniMax M2.5 minimax/minimax-m2.5 MiniMax flagship
Kimi K2.5 moonshotai/kimi-k2.5 Moonshot AI flagship
Grok 4.1 Fast xai/grok-4.1-fast-non-reasoning xAI fast non-reasoning model

If you omit the model field in standard mode, the API defaults to mistral/mistral-small.

Example — Standard Chat with Model Override

curl -X POST 'https://agent.blackbox.ai/api/v1/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "Explain async/await in JavaScript",
    "type": "standard",
    "model": "moonshotai/kimi-k2.5"
  }'