Create an ask-anything response

POST

/v1/ask-anything

Runs the Ask Anything or Selection Ask contract and returns the answer payload.

请求参数

Body 参数application/json必填

示例

{
    "question": "Summarize the main point of this selection.",
    "selectedText": "OneSay should route every non-frontend capability through a unified API boundary first.",
    "askAnythingMode": "summarize",
    "allowsExternalSearch": false,
    "expressionContext": {
        "personalStyle": {
            "preference": "off",
            "customInstruction": "",
            "styleSamples": ""
        },
        "fallbackTone": "natural",
        "appContext": {
            "applicationName": "Notes",
            "bundleIdentifier": "com.apple.Notes"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/ask-anything' \
--header 'Content-Type: application/json' \
--data '{
    "question": "Summarize the main point of this selection.",
    "selectedText": "OneSay should route every non-frontend capability through a unified API boundary first.",
    "askAnythingMode": "summarize",
    "allowsExternalSearch": false,
    "expressionContext": {
        "personalStyle": {
            "preference": "off",
            "customInstruction": "",
            "styleSamples": ""
        },
        "fallbackTone": "natural",
        "appContext": {
            "applicationName": "Notes",
            "bundleIdentifier": "com.apple.Notes"
        }
    }
}'

返回响应

🟢200成功

application/json

Question answered.

Bodyapplication/json

示例

{
    "ok": true,
    "data": {
        "id": "ai_2222222222222222",
        "taskKind": "ask_anything",
        "payload": {
            "taskKind": "ask_anything",
            "answer": "OneSay found three key points in the selected text.",
            "usedExternalSearch": false,
            "externalSearchSources": [],
            "appliedExpression": {
                "personalStyleUsed": false,
                "appToneUsed": false,
                "writingTone": "natural"
            }
        },
        "render": {
            "preferred": "plain_text",
            "plainText": "OneSay found three key points in the selected text.",
            "blocks": [
                {
                    "type": "paragraph",
                    "text": "OneSay found three key points in the selected text."
                }
            ]
        },
        "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

Refine transcript text

Create a text-to-speech response