GPT-OSS 20B

Model ID

gpt-oss-20b

Provider

OpenAI — served by Groq, DeepInfra, DigitalOcean Inference, Hugging Face Inference Providers

Context

131,072-token context window · 65,536 max output tokens

Capabilities

Streaming, JSON mode, Tool calling, Reasoning, Long context, Multilingual

OpenAI’s compact 20B open-weight reasoning model for ultra-fast agents and structured outputs.

Pricing

Input	Output	Cached input	Cache write
$0.075 / MTok	$0.45 / MTok	$0.0075 / MTok	$0.075 / MTok

Typical request (5K input / 1K output tokens): ~$0.0009. Billing is metered per token. Prices are live at GET /api/v1/models/gpt-oss-20b; the values above were read from that endpoint when this page was generated.

Use this model

The SDK examples assume you have created a server-side client.

const completion = await client.chat.completions.create({
  model: "gpt-oss-20b",
  messages: [{ role: "user", content: "Explain edge caching in one paragraph." }],
});

console.log(completion.choices[0].message.content);

completion = client.chat.completions.create(
    model="gpt-oss-20b",
    messages=[{"role": "user", "content": "Explain edge caching in one paragraph."}],
)

print(completion["choices"][0]["message"]["content"])

curl https://www.ninjachat.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NINJACHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-oss-20b","messages":[{"role":"user","content":"Explain edge caching in one paragraph."}]}'

Supported parameters

messages, temperature, max_completion_tokens, top_p, stop, frequency_penalty, presence_penalty, seed, stream, user, routing, tools, tool_choice, response_format, reasoning, reasoning_effort Send only parameters from this list. routing.require_parameters (default true) skips any provider rail that cannot honor every requested parameter, so unsupported parameters reduce the rails eligible to serve the request.

Routing & fallbacks

Pin gpt-oss-20b with model when you want this model’s behavior, or list it in an ordered models array. With ninja/auto first, the router’s top pick runs first and gpt-oss-20b is the explicit fallback; ninja/auto acts as the router only when it is the first entry.

{
  "models": [
    "ninja/auto",
    "gpt-oss-20b"
  ],
  "messages": [
    {
      "role": "user",
      "content": "Explain edge caching in one paragraph."
    }
  ],
  "routing": {
    "allow_fallbacks": true
  }
}

You are billed at the resolved model’s token rates, and only for the successful execution.

Check live support

TypeScript SDK

const model = await client.models.retrieve("gpt-oss-20b");

if (!model.servable) throw new Error("gpt-oss-20b is temporarily unavailable");

console.log({
  contextWindow: model.contextWindow,
  maxOutputTokens: model.maxOutputTokens,
  capabilities: model.capabilities,
  supportedParameters: model.supportedParameters,
  pricing: model.pricing,
  providers: model.providers,
});

Guides: Text generation · Fallbacks · Smart routing · Pricing · All models

Overview

Frontier Models

More Chat Models

Image Models

Video Models

Model ID

Provider

Context

Capabilities

Pricing

Use this model

Supported parameters

Routing & fallbacks

Check live support

Model ID

Provider

Context

Capabilities

​Pricing

​Use this model

​Supported parameters

​Routing & fallbacks

​Check live support

Pricing

Use this model

Supported parameters

Routing & fallbacks

Check live support