Apimatic-open-api-sdk 1.0.0

OpenAPI is a specification for designing and documenting RESTful APIs, enabling clear structure, easy integration, and automated tool support.

Getting Started with OpenAI API

Introduction

Welcome to the OpenAI Postman Collection! This collection provides a comprehensive set of examples to help you get started with the OpenAI API. Easily walkthrough multiple usecases, API Capabilities, and OpenAI's assistant APIs.

The OpenAI API provides a simple interface for developers to create an intelligence layer in their applications powered by OpenAI's state-of-the-art models. The Chat Completions endpoint powers ChatGPT and provides a straightforward way to generate text responses.

Note: This collection is part of a workspace curated by the Postman team to help you explore and work with useful APIs. Learn how to contribute to this collaborative space and its collections here.

---

Getting Started

Step 1: Fork the Collection

Fork the Collection manually or by clicking the Run in Postman button

Step 2: Setup your account

Create an OpenAI account or sign in to an existing one.

Step 3: Fetch your API key

Next, navigate to the API keys page and click on the "Create new secret key" button.

Give your key a name, select a project, and configure all relevant permissions for this API key.

Create the secret key.

Once the Secret Key is created, copy it to your clipboard by clicking the copy button and select "Done" to close the open prompt.

Step 4: Configure the API Key in Postman

Postman provides you with a Vault that let's you store sensitive data locally. Data stored in this vault is not synced with Postman Cloud and can only be accessed in your local Postman Instance.

Using the table below as a guide, add your keys to your vault. A reference to a secret {{vault:openai-secret-key}}} has been added to the collection authorization tab as a Bearer token to be automatically used with all requests in this workspace. If you do not use the same variable name in your vault, please update the authorization tab accordingly.

Key	Value	Allowed Domains
openai-secret-key	your_key_value	https://api.openai.com

---

There are three folders in this collection.

1. OpenAI API - Use Cases: Documents several interesting use cases of the OpenAI API.

2. OpenAI API capabilities: Documents the OpenAI API and includes most of the requests and interfaces that the API exposes. It makes use of the scripts tab to build basic workflows where necessary and test for assertions against the API response.

3. OpenAI Assistants API: Documents the new Assistants API (in Beta) which is designed to help developers build powerful AI assistants capable of performing a variety of tasks

OpenAI API Use Cases

• Text Generation

• Function Calling

• Build a simple FAQ system

  • Create Embeddings of FAQ Answers

  • Create Embedding of User Input

OpenAI API Capabilities

• Chat Completions

  • Chat Completions Reasoning

• Structured Output - Chat Completions

• Predicted Output - Chat Completions

• Embeddings

• Fine Tuning

  • Upload Training File

  • Create a Fine Tuning Job

  • Enable Weights and Biases Integrations

  • List Fine Tuning Jobs

  • List Fine Tuning Events

  • List Fine Tuning Checkpoints

  • Retrieve Fine Tuning Jobs

  • Cancel Fine Tuning Jobs

• Batch API Requests

  • Get Batches

  • Retrieve Batch

  • Cancel Batch

  • List Batch

  • Create Image Variation

• Files

  • Upload Files

  • List Files

  • Retrieve File

  • Delete File

  • Retrieve File Contents

• Image Generation

  • Generate Image

  • Create Image Edit

• Models

  • List Models

  • Retrieve Models

  • Delete Fine Tuned Model

• Moderations

OpenAI Assistants API

• Create Assistant

• List Assistant

• Retrieve Assistants

• Modify Assistants

• Delete Assistants

• Threads

  • Create Thread

  • Retrieve Thread

  • Modify Thread

  • Delete Thread

  • Messages

    • Create Message in a Thread

    • List Messages in a Thread

    • Get Message in Thread

    • Modify Message in Thread

    • Delete Message in Thread

  • Runs

    • Create Thread and Run

    • Create Run

    • List Run

    • Get Run

    • Modify Run

    • Submit Tool Outputs

    • Cancel Run

    • List Run Steps

    • Get Run Steps

    • Create Thread

    • Retrieve Thread

    • Modify Thread

    • Delete Thread

• Vector Store

  • Create Vector Store

  • List Vector Stores

  • Retrieve Vector Store

  • Modify Vector Store

  • Delete Vector Store

  • Vectore Store Files

    • Create Vectore Store File

    • List Vector Store File

    • Get Vector Store File

    • Delete Vector Store File

    • Batches

      • Vector Store File Batch

      • Get Vector Store File Batch

      • Cancel Vectore Store File Batch

      • List Vector Stores in a Files Batch

---

---

Getting Help

We want you to get the best support you can when working with this workspace. If you're stuck and you need help regarding OpenAI specific issues, we recommend that you explore the following channels.

• OpenAI Help Center

• OpenAI Developer Forum

For Postman specific questions or feedback about this workspace:

• Postman's Community Forum - Provide feedback and ask questions about this workspace, ask general Postman questions, understand how to use a feature, how to build a workflow, etc.

For Postman specific issues:

• Postman Github Issues - Submit feature requests, bug reports, etc here

Install the Package

The package is compatible with Python versions 3.7+. Install the package from PyPi using the following pip command:

pip install Apimatic-open-api-sdk==1.0.0

You can also view the package at: https://pypi.python.org/pypi/Apimatic-open-api-sdk/1.0.0

Test the SDK

You can test the generated SDK and the server with test cases. unittest is used as the testing framework and pytest is used as the test runner. You can run the tests as follows:

Navigate to the root directory of the SDK and run the following commands

pip install -r test-requirements.txt pytest

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

Parameter	Type	Description
environment	Environment	The API environment. Default: Environment.PRODUCTION
http_client_instance	HttpClient	The Http Client passed from the sdk user for making requests
override_http_client_configuration	bool	The value which determines to override properties of the passed Http Client from the sdk user
http_call_back	HttpCallBack	The callback value that is invoked before and after an HTTP call is made to an endpoint
timeout	float	The value to use for connection timeout. Default: 60
max_retries	int	The number of times to retry an endpoint call if it fails. Default: 0
backoff_factor	float	A backoff factor to apply between attempts after the second try. Default: 2
retry_statuses	Array of int	The http statuses on which retry is to be done. Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]
retry_methods	Array of string	The http methods on which retry is to be done. Default: ['GET', 'PUT']
bearer_auth_credentials	BearerAuthCredentials	The credential object for OAuth 2 Bearer token

The API client can be initialized as follows:

from openaiapi.configuration import Environment
from openaiapi.http.auth.o_auth_2 import BearerAuthCredentials
from openaiapi.openaiapi_client import OpenaiapiClient

client = OpenaiapiClient(
    bearer_auth_credentials=BearerAuthCredentials(
        access_token='AccessToken'
    ),
    environment=Environment.PRODUCTION
)

Authorization

This API uses the following authentication schemes.

• bearer (OAuth 2 Bearer token)

List of APIs

• Text Generation-Chat Completions API
• Function Calling-Chat Completions API
• Builda Simple FAQ System-Embeddings API
• Chat Completions
• Structured Outputs
• Predicted Outputs
• Fine Tuning
• Batch API Requests
• Image Generation
• Vector Store Files
• Vector Store
• Open AI Assistants API-Beta
• Reasoning
• Embeddings
• Files
• Models
• Moderations
• Messages
• Runs
• Threads
• Batches

SDK Infrastructure

HTTP

• HttpResponse
• HttpRequest

Utilities

• ApiHelper
• HttpDateTime
• RFC3339DateTime
• UnixDateTime