openai/openai-openapi

OpenAPI specification for the OpenAI API

What it solves

This repository provides a machine-readable definition of the OpenAI REST API. It eliminates the need for developers to manually write API clients or documentation, ensuring that tools and SDKs stay synchronized with the actual API behavior.

How it works

The project publishes the API's endpoints, authentication methods, parameters, and request/response schemas in OpenAPI 3.1 format (available as openapi.yaml and openapi.json). These files are automatically synchronized from OpenAI's internal source to ensure accuracy.

Who it’s for

Developers who want to build typed clients, create API explorers, configure testing tools, or integrate the OpenAI API into any OpenAPI-compatible workflow.

Highlights

  • Official OpenAPI 3.1 specification for the OpenAI API.
  • Serves as the source for official SDKs in Python, JavaScript/TypeScript, .NET, Go, Java, and Ruby.
  • Machine-readable YAML and JSON formats for easy tool integration.

Related

  • Project
    openai/openai-go

    The official OpenAI Go library provides a type-safe, idiomatic way to integrate OpenAI's models into Go applications, supporting features like streaming, tool calling, and structured outputs.

  • Project
    openai/openai-ruby

    Official Ruby gem for the OpenAI API, offering chat, streaming, agents, realtime WebSockets, file handling, Azure/Bedrock providers, and custom HTTP support.

  • Project
    openai/openai-node

    Official TypeScript/JavaScript SDK for OpenAI’s API, supporting chat, completions, vision, streaming, realtime, file handling, and cloud‑native authentication.

  • Dispatch
    OpenAI API Release

    OpenAI has released a general-purpose text-in, text-out API providing access to models from the GPT-3 family to enable the development of diverse AI-powered applications.

  • Project
    openai/openai-cli

    The OpenAI CLI is an official command-line tool that allows users to interact with the OpenAI REST API directly from their terminal, enabling tasks like image generation, file management, and batch processing without writing custom code.