ApimaticOpenapiSDK 1.0.0

Getting Started with OpenAI API

Introduction

<img src="https://content.pstmn.io/8cd5c341-3e7a-4a7e-b83d-23f7cf048a34/b3BlbmFpLmpwZw==">

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
<img src="https://run.pstmn.io/button.svg" alt="Run In Postman">

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.

<img src="https://content.pstmn.io/39a27206-d751-40b3-b9bd-2f7287aea9b6/U2NyZWVuc2hvdCAyMDI0LTA4LTAyIGF0IDcuNDcuMDLigK9QTS5wbmc=">

Create the secret key.

<img src="https://content.pstmn.io/ea46e770-5e33-45fd-ad85-e7b26eb387e4/U2NyZWVuc2hvdCAyMDI0LTA4LTAyIGF0IDcuNTIuMDLigK9QTS5wbmc=">

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.

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

If you are building with .NET CLI tools then you can also use the following command:

dotnet add package ApimaticOpenapiSDK --version 1.0.0

You can also view the package at: https://www.nuget.org/packages/ApimaticOpenapiSDK/1.0.0

Test the SDK

The generated SDK also contain one or more Tests, which are contained in the Tests project. In order to invoke these test cases, you will need NUnit 3.0 Test Adapter Extension for Visual Studio. Once the SDK is complied, the test cases should appear in the Test Explorer window. Here, you can click Run All to execute these test cases.

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

The API client can be initialized as follows:

using OpenAIAPI.Standard;
using OpenAIAPI.Standard.Authentication;

namespace ConsoleApp;

OpenAIAPIClient client = new OpenAIAPIClient.Builder()
    .BearerAuthCredentials(
        new BearerAuthModel.Builder(
            "AccessToken"
        )
        .Build())
    .Environment(OpenAIAPI.Standard.Environment.Production)
    .Build();

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

Configuration

• HttpClientConfiguration
• HttpClientConfigurationBuilder
• ProxyConfigurationBuilder

HTTP

• HttpCallback
• HttpContext
• HttpRequest
• HttpResponse
• HttpStringResponse

Utilities

• ApiException
• ApiHelper