# OpenAI AI integration on Definable

> 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.

## What this connects

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.

Vendor: https://platform.openai.com/signup

## Tools available

**126** tools available. First 12:

- `OPENAI_ADD_UPLOAD_PART` — Add Upload Part — Tool to add a part (chunk of bytes) to an Upload object. Use when uploading large files in chunks, with each part up to 64 MB.
- `OPENAI_CANCEL_BATCH` — Cancel batch — Tool to cancel an in-progress batch. Use when you need to stop a batch that is currently processing. The batch will be in status 'cancelling' for up to 10 minutes before changing to 'cancelled', where partial results (if any) will be available.
- `OPENAI_CANCEL_EVAL_RUN` — Cancel evaluation run — Tool to cancel an ongoing evaluation run. Use when you need to stop an evaluation run that is currently in progress.
- `OPENAI_CANCEL_RESPONSE` — Cancel Response — Tool to cancel a background model response by its ID. Use when you need to stop a response that was created with the 'background' parameter set to true. Only background responses can be cancelled; attempting to cancel a non-background response will fail.
- `OPENAI_CANCEL_RUN` — Cancel Run — Tool to cancel a run that is currently in progress. Use when you need to stop an assistant run that is taking too long or is no longer needed. The run's status will transition to 'cancelling' and then 'cancelled'.
- `OPENAI_CANCEL_UPLOAD` — Cancel upload — Tool to cancel an upload. Use when you need to stop an upload that is in progress. No parts may be added after cancellation.
- `OPENAI_COMPACT_RESPONSE` — Compact Response — Tool to compact a conversation or response to reduce token usage. Use when you need to reduce the size of long conversations while preserving important context. Either provide an array of input messages or reference a previous response ID to compact.
- `OPENAI_CREATE_AUDIO_TRANSCRIPTION` — 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.
- `OPENAI_CREATE_AUDIO_TRANSLATION` — Create Audio Translation — Tool to translate audio files to English text via OpenAI Audio Translations API. Use when you need to convert speech in audio files (any language) to English text.
- `OPENAI_CREATE_BATCH` — Create Batch — Tool to create and execute a batch from an uploaded file of requests. Use after uploading a JSONL file with purpose 'batch' to process multiple API requests in a single batch operation.
- `OPENAI_CREATE_CHAT_COMPLETION` — Create Chat Completion — Tool to create a chat completion response from OpenAI models. Use for conversational AI, text generation, function calling, multimodal tasks with vision/audio, and structured JSON outputs. Supports advanced features like reasoning models, tool use, and streaming responses.
- `OPENAI_CREATE_COMPLETION` — Create Completion (Legacy) — Tool to generate text completions using OpenAI's legacy Completions API. Use for single-turn text generation with models like gpt-3.5-turbo-instruct. Note: This endpoint is legacy; prefer Chat Completions for newer models.

## Auth

Auth schemes: `API_KEY`.

## How agents use OpenAI

Inside a Definable workflow, OpenAI is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → OpenAI** — the Researcher (GPT-5.5) pulls context from OpenAI (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → OpenAI** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into OpenAI (create record, post message, draft email).
- **Designer / Engineer → Distributor → OpenAI** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via OpenAI (attach file, open PR comment, post status).

The Verifier checks every OpenAI call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- artificial intelligence — https://definable.ai/apps/category/artificial-intelligence/
- ai models — https://definable.ai/apps/category/ai-models/

## Related

- HTML page: https://definable.ai/apps/openai/
- Same category (artificial intelligence): https://definable.ai/apps/category/artificial-intelligence/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt