深圳市专企云算科技有限公司 API 文档
    • 平台介绍
    • 快速开始
    • 模型列表与选择
    • 国内模型接入方式
    • 错误处理
    • 视频与异步任务说明
    • 模型
      • 获取可用模型
        GET
    • 文本与多模态
      • 创建对话响应
        POST
    • 向量
      • 创建文本向量
        POST
    • 重排序
      • 重排序候选文档
        POST
    • 图片
      • 生成图片
        POST
    • 音频
      • 创建语音
        POST
      • 创建语音转写
        POST
    • 视频
      • 创建视频任务
        POST
      • 查询视频状态和实际Tokens
        GET
      • 下载已成功的视频
        GET
    • 数据模型
      • ErrorResponse
      • ZQVideoTaskEnvelope
      • Model
      • ZQVideoUsage
      • ModelList
      • ZQVideoAPIError
      • ChatContentPart
      • ZQVideoCreateVideoRequest
      • ChatMessage
      • ZQVideoTask
      • ChatCompletionRequest
      • ZQVideoCreatedVideo
      • Usage
      • ZQVideoContentItem
      • ChatChoice
      • ZQVideoVideoOptions
      • ChatCompletionResponse
      • EmbeddingRequest
      • EmbeddingData
      • EmbeddingResponse
      • RerankRequest
      • RerankResult
      • RerankResponse
      • ImageGenerationRequest
      • ImageData
      • ImageGenerationResponse
      • SpeechRequest
      • TranscriptionRequest
      • TranscriptionResponse

    国内模型接入方式

    专企云算按能力与协议类型组织接口。以下为通用兼容协议说明,具体能否调用、支持哪些参数,由平台已开放的目标模型和适配能力决定。通用 Schema 中存在某个字段,不表示所有模型均支持该字段。
    对采用同一协议、且所需参数都被目标模型支持的调用,通常可以保留客户端主体并更换 model。跨能力类型或使用模型专属参数时,仍需调整接口与请求体。

    文本与多模态对话#

    使用 POST /v1/chat/completions。基础字段为 model 和 messages;普通文本消息的 content 使用字符串。
    支持视觉输入的模型可按其能力使用包含 text、image_url 的内容数组。图片输入能力与图片生成能力不同。输入图片的格式、大小、可访问性和数量限制应以目标模型要求为准。
    stream、采样参数、最大输出长度、工具调用和思考相关扩展字段均需要目标模型支持。不要把某一模型的扩展参数直接套用到其他模型。

    文本模型的思考选择#

    先用 GET /v1/models 查询自己的 Key 可用的完整模型 ID。以下差异适用于对应已开放模型,不代表所有分组都有这些模型,也不代表其他同名路由具有完全相同能力。
    模型 ID思考模式输入
    deepseek-v4.1-flashenabled/disabled 可选文字、图片
    deepseek-v4-flash-202605enabled/disabled 可选文字
    deepseek-v4-pro-0813enabled/disabled 可选文字
    deepseek-v4-pro-202606enabled/disabled 可选文字
    deepseek/deepseek-v4-flash-vision-expenabled/disabled 可选文字、图片
    glm-5.2enabled/disabled 可选文字
    hy4-preview默认开启,可选 enabled/disabled文字
    glm-5.3固定思考,不能关闭文字
    glm-5.3-flash固定思考,不能关闭文字
    可选思考模型在请求体增加 "thinking":{"type":"enabled"} 开启,改为 "disabled" 关闭。平台不强制覆盖客户选择;省略字段时采用模型默认行为。两个固定思考模型建议省略 thinking,不要用 disabled 期望关闭。
    Python OpenAI SDK 的 Base URL 为 https://zhuanqicloud.com/v1,扩展字段放在 extra_body:
    最终答案读取 choices[0].message.content,思考内容读取 reasoning_content。思考 tokens 也占输出预算并计入输出用量;max_tokens 过小可能只有思考、没有最终答案。流式时分别读取 delta.content 和 delta.reasoning_content,收到 [DONE] 后结束。需要末尾用量可设置 stream_options:{"include_usage":true};未返回 usage 时不要自行补零。

    HY4 Preview 的思考、流式与工具调用#

    hy4-preview 使用相同的 POST /v1/chat/completions,输入为文字。先通过 GET /v1/models 确认自己的Key可见该模型。默认开启思考;显式传 "thinking":{"type":"disabled"} 关闭,enabled 开启。thinking 必须是对象,thinking.type 仅接受这两个值;off、on 等其他枚举返回400,并定位 error.param,不会静默采用默认思考继续调用。
    {
      "model": "hy4-preview",
      "messages": [{"role": "user", "content": "解释二分查找。"}],
      "thinking": {"type": "disabled"},
      "max_tokens": 1024
    }
    Python OpenAI SDK 的Base URL为 https://zhuanqicloud.com/v1,HY4扩展参数放入 extra_body={"thinking":{"type":"disabled"}};JavaScript/TypeScript请求中的 thinking 在请求体顶层。开启思考时,max_tokens 同时限制思考和最终回答;预算耗尽可能返回 finish_reason:"length",正文尚未生成。模型上下文1024K、最大输入960K、最大输出64K是能力上限,不是平台自动补充的预算。
    最终答案读取 message.content,思考内容读取实际存在的 message.reasoning_content。流式请求用 "stream":true,"stream_options":{"include_usage":true},分别读取 delta.content 与 delta.reasoning_content;在含用量的帧读取 usage,收到 [DONE] 后结束。没有usage时不补零。
    工具声明沿用OpenAI函数格式。tool_choice 既可以是 "auto"、"none"、"required",也可以是指定函数对象;函数名必须在 tools 中声明:
    {
      "tools": [{
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "查询城市天气",
          "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
            "additionalProperties": false
          }
        }
      }],
      "tool_choice": {"type": "function", "function": {"name": "get_weather"}}
    }
    HY4已包含关闭思考+指定函数对象、开启思考+auto的工具往返样本。调用方校验、执行工具并回传结果;下一轮保留原assistant消息的 tool_calls 及实际存在的 reasoning_content,追加 {"role":"tool","tool_call_id":"对应调用id","content":"工具结果字符串"}。DeepSeek的强制工具限制不直接套用于HY4。
    结构化输出支持 response_format:{"type":"json_object"} 及已通过的简单JSON Schema案例。提示中同时说明JSON字段,并按目标Schema校验响应;一个简单Schema通过不代表所有关键字均被支持。usage.completion_tokens 是输出总量,reasoning_tokens 是其中明细,不能再加一次计费。HY4若收到超出输出总量的思考子计数,平台省略该异常子项并留存诊断,输入、输出总量与扣费不变;子项缺失不代表思考用量为零。缓存命中读取实际返回字段,不用最终答案字数推算用量。

    V4.1 Flash 和 Vision 的图片输入#

    这两个模型理解图片并输出文字,不生成图片。使用 messages 的 content 数组:
    {
      "model":"deepseek-v4.1-flash",
      "messages":[{"role":"user","content":[
        {"type":"text","text":"请描述图片。"},
        {"type":"image_url","image_url":{"url":"https://example.com/picture.png"}}
      ]}],
      "thinking":{"type":"disabled"},
      "max_tokens":1024
    }
    将 example.com 占位地址替换为可直接读取的 HTTPS 图片链接,也可使用 data:image/png;base64,...。不要提交本地路径或需要登录的网页。使用 Vision 模型时将 model 替换为 deepseek/deepseek-v4-flash-vision-exp。
    V4.1 Flash 支持 response_format:{"type":"json_object"},同时在消息中明确要求 JSON;当前不支持严格 json_schema。其他模型高级参数以模型详情为准,不要直接套用。
    价格以模型广场实时人民币单价及分组价格为准,使用日志可核对实际用量和档位。不要仅按可见答案字数估算费用。429 表示触及请求或 tokens 速率限制,不等于固定最大并发;如有 Retry-After 可据此延迟重试。

    工具调用、参数错误与预算检查(2026-10-12)#

    使用上表对应模型的思考开关时,只传 thinking:{"type":"enabled"} 或 disabled;thinking必须是对象。固定思考两款收到disabled返回HTTP400,错误字段为thinking.type。DeepSeek/GLM各款不要用enable_thinking,也不要混用thinking与reasoning_effort;平台不静默修改客户选择。
    DeepSeek开启思考(含默认开启)不支持强制工具 tool_choice:"required" 或指定函数对象,此组合返回400并定位tool_choice。强制工具必须显式关闭思考;auto/none不受此项校验限制,但开启思考+auto本次不作为完整工具能力承诺。
    tools使用OpenAI函数定义,客户端校验并执行函数;下一轮保留assistant消息(含tool_calls,及实际返回的reasoning_content),追加 {"role":"tool","tool_call_id":"对应调用id","content":"工具执行结果"}。不要把函数参数当作可直接执行的命令。
    思考示例预算改为4096起步,不是保证最小值;GLM-5.3系列也可能预算耗尽而未给出正文。读取finish_reason,length说明截断;正文空不等于未消耗tokens。平台不自动扩大预算、不自动追加付费请求。
    usage.completion_tokens包含思考;reasoning_tokens只是明细,不重复相加。缓存读取prompt_tokens_details.cached_tokens或实际返回的prompt_cache_hit_tokens。缺失标为未提供;异常原值留存供排查,HY4超出输出总量的思考子项在客户响应中省略,不补零、不改账单。
    缺少messages返回400;模型不存在或当前Key所属可用分组未配置返回404/model_not_found。Key模型权限限制仍返回403;已配置但渠道暂不可用返回503/channel_unavailable。400/403/404不要盲目重试。数据库或服务故障仍5xx,不能当作参数问题。
    这里验收的是OpenAI Chat Completions;这些模型的Anthropic /v1/messages 思考开关及等价行为不在承诺范围内,不能以返回200证明完整兼容。数学或事实关键业务应校验结果;Pro-202606关闭思考已有小样本算术错误,建议思考开启或计算工具,不代表平台可修复模型权重。
    cURL示例的 $NEW_API_KEY 是Bash环境变量名,应先在本地设置平台Key;PowerShell用 $env:NEW_API_KEY,Python用 os.environ["NEW_API_KEY"]。不要将变量名当真实Key,不要把真实Key写入共享脚本。

    文本向量化#

    使用 POST /v1/embeddings。通用请求包含 model 与 input,其中 input 可按模型能力使用单条文本或文本数组。
    响应中的 data[].embedding 为向量,data[].index 用于对应输入顺序。批量条数、输入长度和向量维度限制因模型而异;只有支持自定义维度的模型才能使用 dimensions 等可选参数。

    文档重排序#

    使用 POST /v1/rerank。提交 model、query 和候选文本数组 documents,按 results[].relevance_score 读取相关性结果,并通过 results[].index 对应原始候选文档。
    top_n、return_documents 等为可选字段,支持范围和默认行为以目标模型及平台适配为准。客户端应保留原始候选数组,不依赖响应一定返回文档正文。

    图片生成#

    使用 POST /v1/images/generations。基础请求包含 model 和 prompt。
    size、n、response_format 以及其他高级字段受模型能力限制,不能把某个示例中的尺寸、张数上限或返回格式当作平台统一承诺。响应可能通过 data[].url 或 data[].b64_json 提供图片,客户端应按实际返回处理。
    下载返回的图片地址时,不要把专企云算 API Key 附加到第三方域名。临时资源应在可用时及时保存,保存时效以接口实际说明为准。

    语音合成#

    使用 POST /v1/audio/speech。通用请求包含 model、input 和目标模型支持的 voice。
    音色标识必须来自该模型的能力说明;VOICE_ID 或其他占位符不能直接调用,也不存在文档统一保证可用的 default 音色。输出格式、语速范围与输入长度限制因模型而异。
    通用兼容成功响应为音频二进制内容。客户端应根据响应 Content-Type 保存或播放,不要将音频内容按 JSON 解析;失败时则检查 HTTP 状态与错误响应。

    语音识别#

    使用 POST /v1/audio/transcriptions,通过 multipart/form-data 上传 file 并指定 model。使用客户端的表单上传功能自动生成 boundary,不要手动把 multipart 请求头写成不带 boundary 的固定字符串。
    音频大小、格式、语言和附加提示词支持情况由目标模型决定。JSON 格式的通用成功响应通过 text 返回识别内容;若使用目标模型支持的 response_format: text,应按纯文本响应处理。

    视频与异步任务#

    Seedance 2.0、2.5 使用异步任务流程。请求提交后需要获取任务 ID、查询状态,再获取生成结果;提交成功不等于视频已经生成完成。
    具体请求路径、参数、任务状态和结果字段请查看 视频与异步任务说明。不同协议的模型不会因为名称相近就自动兼容,不能用其他平台的私有接口路径替代专企云算文档中的路径。
    协议说明未覆盖的模型专属能力,可通过 service@zhuanqicloud.com 或 zhuanqicloud@gmail.com 联系支持人员。
    上一页
    模型列表与选择
    下一页
    错误处理
    Built with