Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions api-reference/models/gpt-oss-20b.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: "gpt-oss-20b"
sidebarTitle: "gpt-oss-20b"
description: "Model details for gpt-oss-20b. Summarization and reasoning over supplied context with a 131,072-token context window."
openapi: "api-reference/openapi/playgrounds/gpt-oss-20b.openapi.json POST /chat/completions"
---

> OpenAI's gpt-oss-20b is an open-weight Mixture-of-Experts model with 21B total parameters (3.6B active per token), served on ZeroGPU as an MXFP4 build. It is built for summarizing complex information, answering questions from supplied context, and working through multi-step instructions, and it carries a 131,072-token context window. It runs on eligible edge GPUs with cloud fallback, which makes it the lighter and cheaper of ZeroGPU's two gpt-oss models.

**References:** [Model docs](https://huggingface.co/openai/gpt-oss-20b) • [Terms](https://github.com/openai/gpt-oss/blob/main/LICENSE) • [Privacy](https://zerogpu.ai/privacy-policy)
2 changes: 1 addition & 1 deletion api-reference/models/zlm-v1-tool-decisions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: "Model details for zlm-v1-tool-decisions. MCP tool selection with q
openapi: "api-reference/openapi/playgrounds/zlm-v1-tool-decisions.openapi.json POST /responses"
---

> ZeroGPU's tool-decision model turns user intent into action, pairing fast MCP tool selection with query and argument generation. It reads the conversation, selects the tools that fit, and generates the inputs needed to call them, with the decision and the generation happening in a single inference step so an agent moves from understanding a request to acting on it. When no tool is needed it returns `NO_TOOL`, which keeps unnecessary calls out of the workflow. At 0.6B parameters, served as a bf16 build with a 24,576-token context window, it is built for agents that need to choose quickly and act precisely.
> ZeroGPU's tool-decision model turns user intent into action, pairing fast MCP tool selection with query and argument generation. It reads the conversation, selects the tools that fit, and generates the inputs needed to call them, with the decision and the generation happening in a single inference step so an agent moves from understanding a request to acting on it. When no tool is needed it returns `NO_TOOL`, which keeps unnecessary calls out of the workflow. At 0.6B parameters, served as a Q8_0 quantized build with a 24,576-token context window, it is built for agents that need to choose quickly and act precisely.

**References:** [Model docs](https://huggingface.co/Qwen/Qwen3-0.6B) • [Terms](https://huggingface.co/Qwen/Qwen3-0.6B/blob/main/LICENSE) • [Privacy](https://zerogpu.ai/privacy-policy)

Expand Down
178 changes: 178 additions & 0 deletions api-reference/openapi/playgrounds/gpt-oss-20b.openapi.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
{
"openapi": "3.1.0",
"info": {
"title": "gpt-oss-20b playground",
"version": "1.0",
"description": "Interactive playground for **gpt-oss-20b**.\nModel is always `gpt-oss-20b` on this page (shown in the form, not editable).\nAuthentication: `x-api-key`, or the OpenAI-compatible `Authorization: Bearer` header. `x-project-id` is optional."
},
"servers": [
{
"url": "https://api.zerogpu.ai/v1",
"description": "Production"
}
],
"security": [
{
"ApiKey": []
},
{
"BearerAuth": []
}
],
"paths": {
"/chat/completions": {
"post": {
"operationId": "createChatCompletion_gpt-oss-20b",
"summary": "gpt-oss-20b: Chat completions",
"tags": [
"gpt-oss-20b"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CreateChatCompletionRequest"
},
{
"type": "object",
"properties": {
"model": {
"type": "string",
"const": "gpt-oss-20b",
"default": "gpt-oss-20b",
"example": "gpt-oss-20b",
"description": "Model identifier (fixed for this playground). Use request examples to change use cases."
}
}
}
]
},
"examples": {
"default": {
"summary": "Default",
"value": {
"model": "gpt-oss-20b",
"messages": [
{
"role": "user",
"content": "The global semiconductor industry is undergoing one of its most significant structural shifts in decades, driven by a combination of geopolitical tensions, surging demand from artificial intelligence workloads, and a wave of government-backed industrial policy across the United States, Europe, and Asia. At the center of this transformation is a race to onshore chip manufacturing capacity that had, for thirty years, been quietly concentrated in Taiwan and South Korea. The United States CHIPS and Science Act, signed into law in 2022, allocated over $52 billion in subsidies to incentivize domestic semiconductor fabrication. Since then, companies including TSMC, Intel, Samsung, and Micron have announced or broken ground on new fabs in Arizona, Ohio, Texas, and Idaho. However, construction timelines have slipped, costs have ballooned, and a shortage of skilled workers has prompted some manufacturers to bring in engineers from overseas — a move that has drawn political scrutiny even as it addresses a genuine talent gap. Meanwhile, the explosion of AI model training and inference has fundamentally altered the demand profile for chips. Graphics processing units originally designed for gaming, particularly those made by NVIDIA, have become the primary compute substrate for large language models. NVIDIA's H100 and successor Blackwell-series GPUs now trade at significant premiums on secondary markets, with some hyperscalers reporting lead times of over a year for large cluster orders. This bottleneck has accelerated investment in custom silicon: Google's Tensor Processing Units, Amazon's Trainium and Inferentia chips, and Meta's MTIA accelerators are all attempts to reduce dependence on third-party GPU supply chains. On the geopolitical front, the United States has progressively tightened export controls on advanced chips and chip-making equipment destined for China, with the most recent rules targeting gate-all-around transistor technology and high-bandwidth memory. China, in response, has dramatically increased state investment in its domestic semiconductor ecosystem, with companies like SMIC and Huawei making incremental but closely watched progress at advanced nodes. Analysts remain divided on how quickly China can close the gap, with estimates ranging from five to fifteen years depending on assumptions about technology transfer, equipment access, and the pace of indigenous innovation. The equipment layer — often overlooked in public discourse — may prove to be the most consequential chokepoint. ASML, the Dutch company that holds a near-monopoly on extreme ultraviolet lithography machines, has become a focal point of both trade diplomacy and industrial strategy. Without EUV tools, fabricating chips below 7 nanometers at scale is effectively impossible, giving ASML and its supply chain extraordinary leverage in a world where nations are suddenly treating semiconductor access as a matter of national security."
}
]
}
}
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ChatCompletionResponse"
}
}
}
},
"400": {
"description": "Bad request"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"420": {
"description": "Insufficient quota"
},
"500": {
"description": "Internal server error"
}
},
"parameters": [
{
"name": "x-project-id",
"in": "header",
"required": false,
"schema": {
"type": "string"
},
"description": "Optional project identifier. Scopes the request to a specific project when provided."
}
]
}
}
},
"components": {
"securitySchemes": {
"ApiKey": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
},
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "OpenAI-compatible: send your ZeroGPU API key as `Authorization: Bearer <key>`."
}
},
"schemas": {
"CreateChatCompletionRequest": {
"type": "object",
"required": [
"model",
"messages"
],
"properties": {
"model": {
"type": "string",
"const": "gpt-oss-20b",
"default": "gpt-oss-20b",
"example": "gpt-oss-20b",
"description": "Model identifier (fixed for this playground). Use request examples to change use cases."
},
"messages": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ChatMessage"
}
}
}
},
"ChatMessage": {
"type": "object",
"required": [
"role",
"content"
],
"properties": {
"role": {
"type": "string",
"enum": [
"system",
"user",
"assistant"
]
},
"content": {
"type": "string",
"minLength": 1,
"format": "textarea",
"maxLength": 131072,
"description": "Message text."
}
}
},
"ChatCompletionResponse": {
"type": "object",
"additionalProperties": true
}
}
}
}
1 change: 1 addition & 0 deletions api-reference/openapi/zerogpu.openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -1140,6 +1140,7 @@
"LFM2.5-1.2B-Instruct",
"LFM2.5-1.2B-Thinking",
"gpt-oss-120b",
"gpt-oss-20b",
"qwen3-30b-a3b-fp8",
"qwen3.6-35b-a3b",
"deepseek-v4.1-flash",
Expand Down
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,7 @@
"group": "By model",
"pages": [
"api-reference/models/gpt-oss-120b",
"api-reference/models/gpt-oss-20b",
"api-reference/models/qwen3-30b-a3b-fp8",
"api-reference/models/qwen3-6-35b-a3b",
"api-reference/models/unlimited-ocr",
Expand Down
Loading