深圳市专企云算科技有限公司 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

    快速开始

    1. 准备 API Key#

    在专企云算控制台创建 API Key,并确认账户余额、分组和密钥限制满足调用需求。请妥善保管密钥,不要把它写入公开代码仓库、网页前端或客户端分发包。
    调用专企云算 API 时,在请求头中携带:
    示例中的 YOUR_API_KEY、MODEL_ID 都是占位符。以下 curl 示例采用 Bash 语法;Windows 用户可通过 WSL、Git Bash 或按所用终端的语法调整引号与续行。

    2. 获取当前模型列表#

    从响应的 data[].id 取得模型 ID,再根据控制台的能力说明选择目标模型。列表中可能同时出现文本、图片、音频和视频模型,不能把任意模型都提交到对话接口。

    3. 发起文本对话#

    将 MODEL_ID 替换为当前账户可见、支持对话接口的模型 ID:
    非流式兼容响应中的正文通常位于 choices[0].message.content。思考内容、工具调用等字段取决于模型和平台适配能力,不能假定每个模型都返回相同的扩展字段。

    4. 流式响应#

    对支持流式输出的对话模型,可使用 stream: true。curl -N 用于关闭输出缓冲,便于实时查看事件:
    兼容协议通常以 text/event-stream 返回 SSE 事件。客户端应按空行划分事件,解析 data: 内容,并按顺序拼接 choices[].delta.content;部分事件可能只包含角色、结束原因或其他字段,不一定包含正文。
    收到 data: [DONE] 时结束解析,不要把它当作 JSON。若连接在结束标记前中断,或流中出现错误信息,应将本次结果标记为未完成;HTTP 请求开始时成功不代表整段流最终成功。不要假设每个网络数据块都恰好是一条完整事件。

    5. Base URL 拼接规则#

    调用方式地址配置
    直接使用 HTTP 或 curl使用完整地址,如 https://zhuanqicloud.com/v1/chat/completions
    客户端自动追加 /chat/completions 等路径Base URL 设置为 https://zhuanqicloud.com/v1
    客户端已经自动追加 /v1/chat/completionsBase URL 设置为 https://zhuanqicloud.com
    检查客户端最终请求地址,避免出现 /v1/v1/ 或遗漏 /v1/。文档域名 docs.zhuanqicloud.com 用于阅读文档,不能作为 API Base URL。

    6. 图片、音频与视频#

    图片和音频模型需要使用各自的接口、字段及文件格式。视频生成采用异步任务流程,请查看 视频与异步任务说明,不要向 /v1/chat/completions 提交视频任务。
    遇到问题时,请向 service@zhuanqicloud.com 或 zhuanqicloud@gmail.com 提供请求时间、接口路径、模型 ID、任务 ID(如有)及脱敏错误信息,不要发送完整 API Key。
    上一页
    平台介绍
    下一页
    模型列表与选择
    Built with