OpenAI

🔑 BYO Key — AI

AI-powered text and image generation. Use GPT for content, translations, and summaries. Use DALL-E 3 or GPT Image for AI-generated images. Bring your own API key.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

openai_api_key

API Key

Find your API key at platform.openai.com → API keys. Starts with "sk-". Usage is billed to your OpenAI account.

Get your API key at platform.openai.com →

Endpoints (4)

POST chat-completion

Generate text using GPT. Use for content writing, translations, summaries, extraction, and classification. Returns the model response.

Field	Type	Required	Description
`model`	string	No	Model to use. Default: "gpt-4o-mini". Options: "gpt-4o", "gpt-4o-mini", "gpt-4.1-mini", "gpt-4.1-nano", "o3-mini".
`messages`	array	✓ Yes	Array of messages: [{role: "system"\|"user"\|"assistant", content: "..."}]. System message sets behavior, user message is the prompt.
`max_tokens`	integer	No	Maximum tokens in the response (default: 1024). 1 token ≈ 0.75 words.
`temperature`	string	No	Creativity level 0.0-2.0. Lower = more focused, higher = more creative. Default: 1.0.

POST generate-image

Generate an image from a text prompt using DALL-E 3 or GPT Image. Returns the image URL (valid for 1 hour) or base64 data.

Field	Type	Required	Description
`prompt`	string	✓ Yes	Text description of the image to generate. Be specific and detailed for best results.
`model`	string	No	Model: "dall-e-3" (default, high quality) or "gpt-image-1" (newer, more creative).
`size`	string	No	Image size. DALL-E 3: "1024x1024" (default), "1024x1792" (portrait), "1792x1024" (landscape). GPT Image: also supports "256x256", "512x512".
`quality`	string	No	"standard" (default, faster) or "hd" (more detailed, DALL-E 3 only).
`style`	string	No	"vivid" (default, dramatic) or "natural" (more realistic, DALL-E 3 only).
`n`	integer	No	Number of images to generate (1-4 for GPT Image, always 1 for DALL-E 3).
`response_format`	string	No	"url" (default, temporary URL valid ~1h) or "b64_json" (base64 data, use for permanent storage via upload_asset).

GET list-models

List all available models on your OpenAI account. Use to verify which models you have access to.

No input parameters required.

POST create-embedding

Generate text embeddings for semantic search, similarity matching, or classification. Returns a vector of floats.

Field	Type	Required	Description
`input`	string	✓ Yes	Text to embed. Max ~8000 tokens for text-embedding-3-small.
`model`	string	No	Embedding model. Default: "text-embedding-3-small". Alternative: "text-embedding-3-large" (more dimensions).

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
chat-completion	`openai_chat_completion`
generate-image	`openai_generate_image`
list-models	`openai_list_models`
create-embedding	`openai_create_embedding`

← Back to all integrations