OpenAI | Drafts Script Reference

Class OpenAI

Script integration with OpenAI API. This object offers convenience over direct HTTP requests by:

Integrating with Drafts Credentials system to store your API key.
Handling request authorization headers for requests
Parsing results to JSON
Providing several convenience functions that wrap more complex API calls into simple requests.

NOTE: Drafts does not provide an API Key for use with OpenAI. To use OpenAI features, you will have to setup your own OpenAI account and generate an API Key for use with Drafts in the developer portal.

Example

Translation

// build prompt
const targetLanguage = "Spanish"
const text = "Where is the library?"
const chatPrompt = `Translate the following text into ${targetLanguage}: "${text}"`

// create OpenAI API object and use single response
// convenience function to send prompt
let ai = new OpenAI()
let answer = ai.quickChatResponse(chatPrompt)

// answer == "¿Dónde está la biblioteca?"

Direct API Request

// create OpenAI object
let ai = new OpenAI()

// make API request
let response = ai.request({
	"path": "/chat/completions",
	"method": "POST",
	"data": {
		"model": "gpt-3.5-turbo",
		"messages": [
			{
				"role": "user",
				"content": "What is your name?"
			}
		]
	}
})

// report status
console.log(`CODE: ${response.statusCode}

ERR: ${response.error}

${response.responseText}
`)

Note that the OpenAI object can be used with any OpenAI API-compatible provider (such as Deep Seek) by overriding the host parameter when constructing the object.

Convenience

quickChatResponse

quickChatResponse(prompt: string, options?: object): string
Submit a single text prompt to ChatGPT conversations endpoint, and return only the message generated. Convenience method for single request prompts.
Parameters
- prompt: string
  Text prompt to submit to ChatGPT
- Optionaloptions: object
  Optional key-value object specifying other options to include with the request, see Completion docs for supported options. Default model value is gpt-3.5-turbo
Returns string

quickCodeEdit

quickCodeEdit(input: string, instructions: string, options?: object): string
Submit a single text input and instructions to the Edits endpoint, using the code-davinci-edit-001 model to generate code or refactor, and return only the message generated.
Parameters
- input: string
  Text input to submit, generally used only if you are instruction the model to refactor existing code.
- instructions: string
  Instructions to model
- Optionaloptions: object
  Optional key-value object specifying other options to include with the request, see Edit docs for supported options. Default model value is text-davinci-edit-001
Returns string
Deprecated
The edits endpoint was removed by OpenAI

quickTextEdit

quickTextEdit(input: string, instructions: string, options?: object): string
Submit a single text input and instructions to the Edits endpoint, using the text-davinci-edit-001 model, and return only the message generated. Convenience method for single request input.
Parameters
- input: string
  Text input to submit
- instructions: string
  Instructions to model
- Optionaloptions: object
  Optional key-value object specifying other options to include with the request, see Edit docs for supported options. Default model value is text-davinci-edit-001
Returns string
Deprecated
The edits endpoint was removed by OpenAI

Options

`Optional`credentialIdentifier

credentialIdentifier?: string

Optional identifier for API Key credentials. If an API Key is not provided as a parameter when instantiating the object, the user will be prompted to enter one of the first time they run an action requiring it. By default, these will be stored as OpenAI credentials. If you have the need to store multiple API Keys, or use the action with alternate compatible host services (like Perplexity.ai), you can set an alternate identifier for use with the Credential system. Default: OpenAI

model

model: string

Name of the model to use. Model can also be passed as a parameter in requests, but settings this to a supported model will make it the default model for requests using this instance. Default: gpt-3.5-turbo

Other

constructor

new OpenAI(apiKey?: string, host?: string): OpenAI
Create new instance.
Parameters
- OptionalapiKey: string
- Optionalhost: string
Returns OpenAI

timeout

timeout: number

Time in seconds to wait for a request to receive a response from the server. Default: 120 seconds.

request

request(
    settings: {
        data?: { [x: string]: string };
        headers?: { [x: string]: string };
        method: string;
        parameters?: { [x: string]: string };
        path: string;
    },
): HTTPResponse
Execute a request against the OpenAI API. For successful requests, the HTTPResponse object will contain an object or array or objects decoded from the JSON returned by OpenAI as appropriate to the request made. Refer to OpenAI API documentation for details about the expected parameters and responses.
Parameters
- settings: {
      data?: { [x: string]: string };
      headers?: { [x: string]: string };
      method: string;
      parameters?: { [x: string]: string };
      path: string;
  }
  - Optionaldata?: { [x: string]: string }
    An object containing data to be encoded into the HTTP body of the request. Drafts will take care of the JSON conversion.
  - Optionalheaders?: { [x: string]: string }
    An object contain key-values to be added as custom headers in the request. There is no need to provide authorization headers, Drafts will add those.
  - method: string
    The HTTP method, like "GET", "POST", etc.
  - Optionalparameters?: { [x: string]: string }
    An object containing key-values to be added to the request as URL parameters. Drafts will take care of encoding these.
  - path: string
    The path to the API endpoint in the OpenAI API. This should include the path after the API version. For example /chat/completion
Returns HTTPResponse

`Static`create

create(apiKey?: string, host?: string): OpenAI
Creates a new OpenAI object.
Parameters
- OptionalapiKey: string
  A valid OpenAI API Key. This value is optional, and if not provided, the default OpenAPI API key stored in Credentials will be used, or the user prompted to provide an API Key to store. Only provide a specific API Key if you desire to override the default.
- Optionalhost: string
  Optionally provide the API endpoint URL for any OpenAI API compatible endpoint, such as a custom Azure AI instance, or Perplexity.ai API. Defaults to https://api.openai.com
Returns OpenAI

Sunbelt Computer Software

PL/B Language Development and Support

Class OpenAI

Example

Convenience

quickChatResponse

Parameters

Returns string

quickCodeEdit

Parameters

Returns string

Deprecated

quickTextEdit

Parameters

Returns string

Deprecated

Options

`Optional`credentialIdentifier

model

Other

constructor

Parameters

Returns OpenAI

timeout

request

Parameters

`Optional`data?: { [x: string]: string }

`Optional`headers?: { [x: string]: string }

method: string

`Optional`parameters?: { [x: string]: string }

path: string

Returns HTTPResponse

`Static`create

Parameters

Returns OpenAI

Sunbelt Computer Software

PL/B Language Development and Support

Class OpenAI

Example

Convenience

quickChatResponse

Parameters

Returns string

quickCodeEdit

Parameters

Returns string

Deprecated

quickTextEdit

Parameters

Returns string

Deprecated

Options

OptionalcredentialIdentifier

model

Other

constructor

Parameters

Returns OpenAI

timeout

request

Parameters

Optionaldata?: { [x: string]: string }

Optionalheaders?: { [x: string]: string }

method: string

Optionalparameters?: { [x: string]: string }

path: string

Returns HTTPResponse

Staticcreate

Parameters

Returns OpenAI

`Optional`credentialIdentifier

`Optional`data?: { [x: string]: string }

`Optional`headers?: { [x: string]: string }

`Optional`parameters?: { [x: string]: string }

`Static`create