# Where is the documentation for the Python OpenAI SDK?

**URL:** <https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643>\
**Category:** Documentation\
**Tags:** sdk\
**Created:** [January 12, 2024, 4:11am UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643 "2024-01-12T04:11:41Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![alexworden](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/alexworden/32/264171_2.png) [@alexworden](https://community.openai.com/u/alexworden)\
**Post date:** [January 12, 2024, 4:11am UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/1 "2024-01-12T04:11:41Z")

</div>

I’m new to Python so sorry if there’s some convention I’m missing. I’m trying to use the OpenAI SDK but there doesn’t seem to be any way to know what methods it has or what parameters they take and return.

Where can I find this information?

Thanks!

---

<div class="post-metadata">

**Author:** ![PaulBellow](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/paulbellow/32/597962_2.png) [@PaulBellow](https://community.openai.com/u/PaulBellow)\
**Post date:** [January 12, 2024, 4:17am UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/2 "2024-01-12T04:17:55Z")

</div>

Welcome to the best dev forum in history!

Check out the [Quickstart Guide](https://platform.openai.com/docs/quickstart?context=python) if you haven’t yet. Lots of good stuff to get started.

Also of use is the [OpenAI Cookbook](https://cookbook.openai.com/)…

Be sure to come back and ask if you get stuck.

---

<div class="post-metadata">

**Author:** ![marsh](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/marsh/32/285809_2.png) [@marsh](https://community.openai.com/u/marsh)\
**Post date:** [January 12, 2024, 4:29am UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/3 "2024-01-12T04:29:52Z")

</div>

As near as I can tell, they’ve got it all in a single Markdown file at the moment:

`https://github.com/openai/openai-python/blob/main/api.md`

I would expect at some point they’ll prop some actual Sphinx-generated docs, but I haven’t yet been able to find any after poking around for it myself.

---

<div class="post-metadata">

**Author:** ![logankilpatrick](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/logankilpatrick/32/14116_2.png) [@logankilpatrick](https://community.openai.com/u/logankilpatrick)\
**Post date:** [January 16, 2024, 3:02pm UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/4 "2024-01-16T15:02:46Z")

</div>

Yeah, today that page is all we have, I started a thread with the team on getting a fully fledged SDK spec into the docs on [platform.openai.com](http://platform.openai.com).

Might take a few weeks but we should do it.

---

<div class="post-metadata">

**Author:** ![marsh](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/marsh/32/285809_2.png) [@marsh](https://community.openai.com/u/marsh)\
**Post date:** [February 10, 2024, 2:20pm UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/5 "2024-02-10T14:20:32Z")

</div>

Great to hear - thanks, @logankilpatrick!

In the interim, I’ve hacked together an MkDocs site with API ref generated from the OpenAI Python library:

> **[OpenAI Python library documentation · UNOFFICIAL](https://mmacy.github.io/openai-python/)**
>
> Unofficial documentation for OpenAI's Python library

I’m still hacking on it so things might move around a bit, but you can click around and see what’s there, at least.

And, though it’s mentioned on the site, I’ll say it here: those docs are unofficial and unsupported! However, they’re there (for now) if anyone would like to use them.

Enjoy!

---

<div class="post-metadata">

**Author:** ![marsh](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/marsh/32/285809_2.png) [@marsh](https://community.openai.com/u/marsh)\
**Post date:** [February 20, 2024, 5:57am UTC](https://community.openai.com/t/where-is-the-documentation-for-the-python-openai-sdk/583643/6 "2024-02-20T05:57:03Z")

</div>

UPDATE: Fresh Python API reference docs (UNOFFICIAL) just published for new library version **v1.13.0**.

I’ve just started in on the augmentation of the docstrings in the library itself, and while this is but a tiny blip of what still needs documenting, you can see some new stuff here:

- module docstrings that describe the top-level [modules in `resources`](https://mmacy.github.io/openai-python/latest/reference/resources/)
- fancy new docstring for the synchronous [`OpenAI` client](https://mmacy.github.io/openai-python/latest/reference/#src.openai.OpenAI) class
- …and a [docstring for the openai package](https://mmacy.github.io/openai-python/latest/reference/) itself.

Enjoy!
