search

openai / openai-openapi

OpenAPI specification for the OpenAI API
https://platform.openai.com/docs/api-reference/introduction
MIT License
1.28k stars 372 forks source link

Add AsyncAPI spec for Realtime API #347

Open HavenDV opened 1 month ago

HavenDV commented 1 month ago

Specification: https://www.asyncapi.com/en Example: https://github.com/AssemblyAI/assemblyai-api-spec/blob/main/asyncapi.yml

StephenHodgson commented 2 weeks ago

added in #356

StephenHodgson commented 2 weeks ago

Duplicate of #341

HavenDV commented 2 weeks ago

Although schemas have been added to OpenAPI spec and that's great, I think it still makes sense because the OpenAPI spec doesn't describe Realtime interactions, while the AsyncAPI spec is aimed at this and fully describes each step, and client code can be generated and maintained automatically as complexity increases. This is supported by some generators already (e.g. fern - https://buildwithfern.com/), I also plan to support it in my generator - https://github.com/tryAGI/AutoSDK This may also be a motivator for other generators