# OpenAI

Toolkit for OpenAI APIs: manage Assistants, Threads/Messages; upload/list/delete Files; list/retrieve Models (including vision/multimodal); and view fine-tune listings and events.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Tools:** 23
- **Triggers:** 0
- **Slug:** `OPENAI`
- **Version:** 20260217_00

## Tools

### Create Assistant

**Slug:** `OPENAI_CREATE_ASSISTANT`

Tool to create or modify an assistant. - To CREATE a new assistant: Provide 'model' (required) and other optional parameters. - To MODIFY an existing assistant: Provide 'assistant_id' and any parameters to update. When modifying, 'model' is optional.

### Create Audio Transcription

**Slug:** `OPENAI_CREATE_AUDIO_TRANSCRIPTION`

Tool to transcribe audio files to text via OpenAI Audio Transcriptions API. Use when you need to convert speech in audio files to written text, optionally with timestamps or speaker diarization.

### Create Embeddings

**Slug:** `OPENAI_CREATE_EMBEDDINGS`

Tool to generate text embeddings via the OpenAI embeddings endpoint. Use for search, clustering, recommendations, and vector database storage workflows.

### Generate Image

**Slug:** `OPENAI_CREATE_IMAGE`

Tool to generate an image via the OpenAI Images API and return hosted image asset URL and metadata. Use when you need to create images from text descriptions for single-shot image generation.

### Create Message

**Slug:** `OPENAI_CREATE_MESSAGE`

Tool to create a new message in a specific thread. Use when adding messages to an existing conversation after confirming the thread ID.

### Create Response

**Slug:** `OPENAI_CREATE_RESPONSE`

Tool to generate a one-shot model response via the Responses API. Use for multimodal analysis (image + text), OCR/text extraction from images, or structured JSON outputs. For structured outputs, configure text.format with type='json_schema' and your schema. Returns the full Response object including id, output array, and aggregated output_text for parsing structured data.

### Create Run

**Slug:** `OPENAI_CREATE_RUN`

Tool to create a run on a thread with an assistant. Use when you need to execute an assistant to generate responses. Creating a message alone does not cause the assistant to respond; a run is the execution primitive. After creating the run, typically poll the run status until it reaches a terminal state (completed, failed, cancelled, expired), then read the assistant's messages from the thread.

### Create Speech (TTS)

**Slug:** `OPENAI_CREATE_SPEECH`

Tool to generate text-to-speech audio using OpenAI's Audio API. Use when you need to convert text to natural-sounding speech with a choice of voices and models. Returns a hosted audio file URL with metadata, not raw bytes.

### Create Thread

**Slug:** `OPENAI_CREATE_THREAD`

Tool to create a new thread. Use when initializing a conversation with optional starter messages.

### Delete assistant

**Slug:** `OPENAI_DELETE_ASSISTANT`

Tool to delete a specific assistant by its ID. Use when you need to remove an assistant after confirming its ID.

### Delete file

**Slug:** `OPENAI_DELETE_FILE`

Tool to delete a file. Use when you need to remove an uploaded file by its ID after confirming the target.

### List Assistants

**Slug:** `OPENAI_LIST_ASSISTANTS`

Tool to list assistants to discover the correct assistant_id by name or metadata. Use when assistant_id is unknown to avoid 404 errors.

### List files

**Slug:** `OPENAI_LIST_FILES`

Tool to retrieve a list of files. Use when you need to view all files uploaded to your organization.

### List fine-tunes

**Slug:** `OPENAI_LIST_FINE_TUNES`

Tool to list your organization's fine-tuning jobs. Use when you need to review all fine-tune runs.

### List Messages

**Slug:** `OPENAI_LIST_MESSAGES`

Tool to list messages in an Assistants thread to fetch the assistant's generated outputs after a run completes. Use after polling a run to completion to retrieve assistant responses.

### List models

**Slug:** `OPENAI_LIST_MODELS`

Tool to list available models. Use when you need to discover which models you can call. Use after confirming your API key is valid.

### List Run Steps

**Slug:** `OPENAI_LIST_RUN_STEPS`

Tool to list run steps for an Assistants API run to track detailed execution progress, inspect tool calls, and view message creation events. Use after creating a run to monitor its step-by-step execution or to retrieve tool call details after completion.

### Modify thread

**Slug:** `OPENAI_MODIFY_THREAD`

Tool to modify an existing thread's metadata. Use after obtaining the thread ID when you need to update metadata.

### Retrieve assistant

**Slug:** `OPENAI_RETRIEVE_ASSISTANT`

Tool to retrieve details of a specific assistant. Use when you need to confirm assistant metadata before performing further operations.

### Retrieve model

**Slug:** `OPENAI_RETRIEVE_MODEL`

Tool to retrieve details of a specific model. Use when you have a model ID and need to confirm its metadata before using it.

### Retrieve run

**Slug:** `OPENAI_RETRIEVE_RUN`

Tool to retrieve an Assistants run by ID to check status, errors, and usage. Use when polling run status until it reaches a terminal state (completed, failed, cancelled, incomplete, expired) before reading thread messages.

### Retrieve thread

**Slug:** `OPENAI_RETRIEVE_THREAD`

Tool to retrieve details of a specific thread by its ID. Use when you need to fetch thread metadata before listing messages.

### Upload file

**Slug:** `OPENAI_UPLOAD_FILE`

Tool to upload a file for use across OpenAI endpoints. Use before referencing the file in tasks like fine-tuning.
