OpenAI (ChatGPT) ACTION
Create Transcription
Transcribes audio into the input language. See the documentation
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's OpenAI (ChatGPT) account once, then configure and run Create Transcription from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "openai-create-transcription",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
openai: { authProvisionId: "apn_xxxxxxx" },
file: "File Path or URL",
model: "Model",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "openai-create-transcription",
"configured_props": {
"openai": { "authProvisionId": "apn_xxxxxxx" },
"file": "File Path or URL",
"model": "Model"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "openai",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "openai-create-transcription",
arguments: {
file: "File Path or URL",
model: "Model",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
file File Path or URL | string | The file to process. Provide either a file URL or a path to a file in the /tmp directory (for example, /tmp/myFile.txt). See the Assistants Tools guide to learn more about the types of files supported. The Fine-tuning API only supports .jsonl files. Required |
model Model | string | ID of the model to use Required |
include Include | string[] | Additional information to include in the transcription response. logprobs will return the log probabilities of the tokens in the response to understand the model's confidence in the transcription. logprobs only works with response_format set to json and only with the models gpt-4o-transcribe and gpt-4o-mini-transcribe. Optional |
language Language | string | The language of the input audio. Supplying the input language in ISO-639-1 (e.g. en) format will improve accuracy and latency. Optional |
prompt Prompt | string | An optional text to guide the model's style or continue a previous audio segment. The prompt should match the audio language. Optional |
response_format Response Format | string | The format of the output. For gpt-4o-transcribe and gpt-4o-mini-transcribe, the only supported format is json. Optional |
temperature Temperature | string | The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit. Optional |
timestamp_granularities Timestamp Granularities | string[] | The timestamp granularities to populate for this transcription. response_format must be set verbose_json to use timestamp granularities. Either or both of these options are supported: word, or segment. Note: There is no additional latency for segment timestamps, but generating word timestamps incurs additional latency. Optional |
syncDir SyncDir | dir | Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- openai-create-transcription
- Version
- 0.3.6
- App
- OpenAI (ChatGPT)
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗