讲师中心 微信公众号
AI工具推荐 视频效率加速

硅基流动API文档怎么看?接口调用与参数设置说明

酷明君_7873

酷明君_7873

发布时间:2026-08-15 19:23:00

|

1036人浏览过

|

来源于php中文网

原创

硅基流动API文档入口在官网「文档」→「API手册」,需确认版本号为2026年7月后,通过Swagger查看接口定义,重点核对Request URL、Parameters(如model和messages格式)、Responses,并结合模型广场或/v1/models获取模型专属参数。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

硅基流动api文档怎么看?接口调用与参数设置说明

想快速查清硅基流动每个API接口该填什么参数、怎么构造请求、返回值长什么样,直接翻官方文档却找不到入口或被术语绕晕——这不是你一个人的问题。

找到最新版API文档入口

打开硅基流动官网(https://www.php.cn/link/56915424977fb94b0ec40a3f31af89ed),点击顶部导航栏「文档」→「API手册」,页面自动跳转至 Swagger 交互式文档首页。

注意:不要点「开发者指南」或「快速入门」,那里面只有流程图和示例代码,没有可展开的接口定义。

当前文档版本号显示在右上角,如 v1.2026.07,确认时间戳是 【2026年7月之后】 的才代表支持 DeepSeek-V3、R1 和 Qwen2.5 等新模型。

按功能筛选接口类型

左侧菜单栏默认展开「全部接口」,但实际使用中建议先收缩,再逐项勾选:

✔️ 勾选「Chat」→ 查看 /v1/chat/completions(标准对话)

✔️ 勾选「Image Generation」→ 查看 /v1/images/generations(文生图)

✔️ 勾选「Text-to-Speech」→ 查看 /v1/audio/speech(TTS)

✔️ 勾选「Video Generation」→ 查看 /v1/videos/generations(文生视频)

不勾选「Model List」或「Usage」这类管理类接口,它们不参与模型调用,只用于查询配额或模型列表。

查看单个接口的完整定义

点击任意接口标题(如「Creates a model response for the given chat conversation」),右侧展开详细面板。

Generate images & videos with: Gemini 3 Pro Image + Qwen Wan 2.6 (video) via one API key
Generate images & videos with: Gemini 3 Pro Image + Qwen Wan 2.6 (video) via one API key

使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image(图像)和Qwen Wan 2.6(视频)。

下载

重点看三块内容:

① 「Try it」按钮上方的「Request URL」:确认路径是否带 /v1/ 前缀,比如 /v1/chat/completions 是标准路径,/v1/deepseek/chat 是旧版兼容路径,【新项目一律用 /v1/chat/completions】。

② 「Parameters」折叠区:点开后能看到所有必填/选填字段。其中 model 是字符串类型,必须填控制台模型广场里复制的全名(如 deepseek-v3,不是 deepseek);messages 是数组,每个元素含 role 和 content 字段——这里容易漏掉 role: "user" 导致报错 400。

③ 「Responses」区域:200 成功响应里,choices[0].message.content 是你要提取的文本结果;422 错误响应会明确告诉你缺了哪个字段,比如 "model": ["Field required"]。

获取模型专属参数说明

方法一:在模型广场点击任一模型(如 Qwen/Qwen2.5-7B-Instruct)→ 右侧弹窗点「API文档」→ 跳转到该模型适配的接口页,参数说明会额外标注「仅适用于本模型」的字段,例如 tools 在 Qwen 系列中支持,在 DeepSeek-V3 中不生效。

方法二:在通用 API 文档页,滚动到底部「Model-specific Notes」章节,按模型名检索。例如搜索 deepseek-r1,会看到它要求 image_url 字段必须为公网可访问链接,本地 file:// 路径会被拒绝。

方法三:直接调用 GET /v1/models 接口,返回 JSON 列表里每个模型的 input_context_length 和 output_context_length 值,这是决定你能否传入 32k 提示词的关键依据。

调试时快速验证参数组合

第一步:在「Try it」面板填好 API Key、model、messages,其他参数留空 → 点 Send。

第二步:若返回 200,说明基础结构正确;若返回 401,检查密钥是否复制完整(sk-开头共 48 位字符);若返回 404,确认模型名拼写与模型广场完全一致(大小写敏感,含斜杠)。

第三步:成功后,逐个添加选填参数测试效果。比如加 temperature: 0.3 看输出是否更确定,加 max_tokens: 100 看是否截断——每次只改一个参数,避免叠加干扰。

这一步操作起来很简单,直接把文件拖进去就行。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

40

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

160

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

140

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

120

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

80

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

60

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

80

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
腾讯元宝使用手册
腾讯元宝使用手册

共0课时 | 0人学习

DeepSeek手册
DeepSeek手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn