openai/openai-openapi

OpenAPI specification for the OpenAI API

What it solves

It provides a machine-readable, standardized description of the OpenAI REST API. This eliminates the need for developers to manually write client libraries or API explorers by providing a single source of truth for endpoints, authentication, and request/response schemas.

How it works

The project publishes the OpenAI API definition in OpenAPI 3.1 format (available as .yaml and .json files). These files are generated artifacts synchronized from an upstream source, allowing them to be imported into any tool that supports the OpenAPI ecosystem to automate the development of API integrations.

Who it’s for

Developers who want to build typed clients, API explorers, or configure testing tools for the OpenAI API using an OpenAPI-compatible workflow.

Highlights

  • Standardized Format: Uses OpenAPI 3.1 for broad compatibility with industry tools.
  • ** SBOM for API**: Serves as the foundation for official OpenAI SDKs in languages like Python, JavaScript, .NET, Go, Java, and Ruby.
  • Automated Sync: Specifications are automatically synchronized from upstream sources to ensure accuracy.

Related

  • Project
    openai/openai-python

    Official Python SDK for OpenAI’s API, offering sync/async clients, full type‑checked coverage of chat, completions, vision, realtime audio, streaming, pagination, file uploads, webhook verification, and modern workload‑identity authentication (K8s, Azure, GCP, X.509).

  • Project
    openai/openai-node

    The official TypeScript and JavaScript library for the OpenAI REST API, providing typed access to text, vision, and real-time multimodal models.

  • Project
    openai/openai-go

    The official OpenAI Go library that provides type-safe access to the OpenAI REST API for applications written in Go.

  • Project
    openai/openai-cli

    The OpenAI CLI is an official command‑line client for the OpenAI REST API. Install via Homebrew or `go install`, set your API key, and run commands like `openai responses create` or admin queries. It supports custom headers, mutual‑TLS, flexible output formats, file uploads, and can be linked to any version of the OpenAI Go SDK. Licensed under Apache 2.0.

  • Project
    openai/openai-dotnet

    The official OpenAI .NET API library that provides convenient, type-safe access to the OpenAI REST API for .NET applications.