Email or username:

Password:

Forgot your password?
Simon Willison

It turns out OpenAI have a GitHub repository with a 26,000 line YAML OpenAPI schema describing their full API - the same API that's emulated by all sorts of other tools within the LLM ecosystem. Made some notes on that here, plus a YAML exploration tool:
simonwillison.net/2024/Dec/22/

5 comments
balloob

@simon I wish it was standardized as a standalone LLM API. That way it can be expanded with use cases that OpenAI doesn’t cover, and standalone SDKs can be made.

Reusing an API will eventually go wrong as owner of API will only make changes that fit their use cases.

Simon Willison

@balloob yeah, I'm frustrated by that too - I'd love someone to define a proper standard for this stuff

Simon Willison

Just found out the hosted Swagger explorer has a ?url= parameter that can load an external schema, so here's that OpenAI OpenAPI description rendered using that petstore.swagger.io/?url=https

mborus

@simon That's a nice trick.

When I need to analyze an external schema, I currently use a dummy FastAPI project that overrides the automatically generated docs. Which is nice if there's an NDA involved and I can't use external tools to analyze it.

gist.github.com/mborus/392be52

Go Up