帮助中心 · 模型 API

模型 API

接口说明、鉴权、调用方式、错误处理　共 20 篇

模型 API

接口说明、鉴权、调用方式、错误处理

接入准备3 篇

接口总览先看鉴权，再看第一次调用。鉴权与 API Key不需要为不同模型、不同供应商分别建 Key。同一个 Key 能调所有已上架模型，额度从账户余额扣。第一次调用curl curl https://yun.nmgshenghang.cn/v1/chat/completions \ -H "Authorization: Bearer $SHSL_API_…

对话与流式4 篇

模型命名与切换请求体里的 model 填「模型广场」卡片上显示的调用名，一字不差照抄即可：流式输出请求体里 stream: true 。幂等与重试网络抖动时重试是必要的，但重试不能造成重复扣费或重复写入。批量请求一次处理多条，省往返也省钱。

工具与检索5 篇

工具调用与 OpenAI function calling 完全一致。图片理解把 content 从字符串换数组，图片传 URL 或 base64。Embedding 向量（暂未开放）平台目前还没有接入向量模型，调用 /v1/embeddings 会返回 no_upstream。接口已按 OpenAI 规范实现，接入后本节内容直接可用。请求 {"model": "bge-…向量检索怎么用Embedding 把文本变成向量，用余弦相似度找相近内容。工具调用进阶让模型调你的函数，关键是参数 schema 要写严。

多媒体接口4 篇

图像生成请求 { "model": "qwen-image-3.0", "prompt": "一只橘猫坐在窗台上，午后阳光", "n": 1, "size": "1024x1024" } 返回 {"c…视频生成视频渲染要几十秒到几分钟，同步接口会超时。所以拆成「创建任务 + 轮询」两步。语音合成（暂未开放）平台目前还没有接入语音合成模型，调用 /v1/audio/speech 会返回 no_upstream。接口已按 OpenAI 规范实现，接入后本节内容直接可用。请求 { "model": …异步任务与轮询视频生成这类长任务返回任务 ID，要轮询或回调。

运行保障4 篇

错误码手册HTTP 状态码 HTTP type 含义怎么处理 400 invalid_request_error 参数不合法看 error.message 401 authentication_er…限流与配额返回 429 rate_limit_exceeded ，响应头会带重置时间。常见报错逐条把最常见的 12 个报错一次讲清。API Key 轮换Key 用久了要换，泄露了更要马上换。

‹ 返回帮助中心搜索相关 ›