TokenToSea开发者文档
控制台

原生协议调用POST

以厂商原生协议调用少数特殊能力:千问深度研究(流式)与 MiniMax 长文本异步语音合成。

本页内容

POST https://api.tokentosea.com/v1/invoke

部分能力没有对应的通用协议,本接口按厂商原生格式转发请求体(model 由平台固定),并照常预留、结算。

前提:全能密钥或模型密钥,账户可用余额足以覆盖本次预留。Python 示例需要 pip install requests,Node.js 示例需要 Node.js 18+。

支持的型号#

型号能力响应方式
qwen-deep-research、qwen-deep-research-2025-12-15深度研究:自动规划、检索并撰写研究报告只支持流式(SSE),必须传 "stream": true
speech-2.8-hd长文本异步语音合成(按上传的文本文件合成)JSON,异步(202)

截至 2026-10-21,以 GET /v1/models 的 verified_endpoints 为准。

千问深度研究#

参数类型必填说明
modelstring必填qwen-deep-research 或 qwen-deep-research-2025-12-15
inputobject必填DashScope 原生输入,例如 { "messages": [{ "role": "user", "content": "…" }] }
parametersobject可选DashScope 原生参数;平台固定设置 enable_feedback: false(不进入追问环节)
streamboolean必填必须为 true

深度研究包含检索与多轮推理,耗时长、用量大。平台按价格表的上限预留费用(预留金额明显高于常见的实际费用),完成后按厂商返回的累计用量结算,因此账户可用余额需覆盖预留。深度研究型号内置的联网检索不会被平台拦截(其他型号的联网搜索参数会被拒绝)。

响应是 DashScope 原生 SSE 帧,研究的各阶段(规划、检索、撰写)依次输出;报告完成的帧在结算后发出。字段含义见千问深度研究文档。

curl -N https://api.tokentosea.com/v1/invoke \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "qwen-deep-research",
    "input": {"messages": [{"role": "user", "content": "比较太阳能和风能发电的主要特点。"}]},
    "parameters": {},
    "stream": true
  }'

MiniMax 长文本语音合成#

长文本先作为文件上传,再提交异步合成任务。

  1. 上传文本文件

    用 POST /v1/files 上传,model 为 speech-2.8-hd,purpose 为 t2a_async_input。文件为 UTF-8 的 .txt,或包含 .txt / .json 的 .zip。

  2. 提交合成任务

    用返回的 file_tts_… 作为 text_file_id 调用本接口,返回 202。

  3. 获取音频

    用同一个幂等键轮询 /v1/results/{key},完成后 output.data[0] 中是音频的下载链接。

参数类型必填说明
modelstring必填speech-2.8-hd
text_file_idstring必填/v1/files 返回的 file_tts_…,必须由同一把密钥上传,purpose 为 t2a_async_input
voice_settingobject必填MiniMax 原生音色设置,voice_id 必须是系统音色(male-qn-qingse)
audio_settingobject可选MiniMax 原生音频设置,例如 { "format": "mp3" }

预留费用按上传文件时测得的字符上限计算(每个字符按 2 计),完成后按厂商返回的计费字符数结算。

REQUEST_KEY="$(uuidgen)"
curl https://api.tokentosea.com/v1/invoke \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -d '{
    "model": "speech-2.8-hd",
    "text_file_id": "file_tts_…",
    "voice_setting": {"voice_id": "male-qn-qingse"},
    "audio_setting": {"format": "mp3"}
  }'

curl "https://api.tokentosea.com/v1/results/$REQUEST_KEY" \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY"

错误#

状态码code原因与处理
422response_mode_not_verified深度研究未传 "stream": true
422text_file_bound_requiredtext_file_id 不是 t2a_async_input 用途的文件
422use_owned_platform_resourcetext_file_id 不是字符串或不是 file_tts_…
404resource_not_found文件不存在、已过期(30 天),或不是用当前密钥上传的
422voice_not_registeredvoice_id 不是该型号的系统音色
400main_wallet_authorization_failed文本超出单次预留上限

下一步#

    输入关键词搜索全部文档与模型。