Refine transcript text

POST

/v1/refine

Runs the refine pipeline for a completed transcript and returns the polished output.

请求参数

Body 参数application/json必填

示例

{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "transcript": "hey can you help me rewrite this note",
    "workflow": "rewrite",
    "dictionaryWords": [],
    "recognitionPreferences": {
        "languageVariants": {
            "english": "en-US",
            "chinese": "zh-CN",
            "spanish": "es-MX",
            "french": "fr-FR",
            "portuguese": "pt-PT"
        }
    },
    "detectedSourceLanguage": "english",
    "expressionContext": {
        "personalStyle": {
            "preference": "off",
            "customInstruction": "",
            "styleSamples": ""
        },
        "fallbackTone": "natural",
        "appContext": {
            "applicationName": "TextEdit",
            "bundleIdentifier": "com.apple.TextEdit"
        },
        "explicitCommand": {
            "kind": "polish",
            "customInstruction": ""
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/refine' \
--header 'Content-Type: application/json' \
--data '{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "transcript": "hey can you help me rewrite this note",
    "workflow": "rewrite",
    "dictionaryWords": [],
    "recognitionPreferences": {
        "languageVariants": {
            "english": "en-US",
            "chinese": "zh-CN",
            "spanish": "es-MX",
            "french": "fr-FR",
            "portuguese": "pt-PT"
        }
    },
    "detectedSourceLanguage": "english",
    "expressionContext": {
        "personalStyle": {
            "preference": "off",
            "customInstruction": "",
            "styleSamples": ""
        },
        "fallbackTone": "natural",
        "appContext": {
            "applicationName": "TextEdit",
            "bundleIdentifier": "com.apple.TextEdit"
        },
        "explicitCommand": {
            "kind": "polish",
            "customInstruction": ""
        }
    }
}'

返回响应

🟢200成功

application/json

Refine completed.

Bodyapplication/json

示例

{
    "ok": true,
    "data": {
        "id": "ai_1111111111111111",
        "taskKind": "rewrite",
        "payload": {
            "taskKind": "rewrite",
            "sessionID": "11111111-1111-1111-1111-111111111111",
            "text": "Could you help me rewrite this note?",
            "completedAt": "2026-04-01T16:20:00Z",
            "appliedExpression": {
                "personalStyleUsed": false,
                "appToneUsed": false,
                "writingTone": "natural"
            }
        },
        "render": {
            "preferred": "plain_text",
            "plainText": "Could you help me rewrite this note?",
            "blocks": [
                {
                    "type": "paragraph",
                    "text": "Could you help me rewrite this note?"
                }
            ]
        },
        "meta": {
            "provider": "mock",
            "model": "deterministic",
            "providerAttemptChain": [
                {
                    "provider": "mock",
                    "model": "deterministic",
                    "levelAttempted": [
                        "json_schema"
                    ],
                    "success": true,
                    "latencyMs": 42
                }
            ],
            "structuredOutput": {
                "level": "json_schema",
                "nativeSchemaUsed": true,
                "nativeJsonObjectUsed": false,
                "validationPassed": true,
                "normalizationUsed": false,
                "fallbackUsed": false
            },
            "tokenUsage": {
                "inputTokens": 120,
                "outputTokens": 24,
                "totalTokens": 144
            },
            "latencyMs": 42
        },
        "createdAt": "2026-04-01T16:20:00Z"
    }
}

🔴500服务器错误

修改于 2026-08-26 04:04:36

Open a reusable realtime lease gateway

Create an ask-anything response