Developer Docs

超智湃 API

通过一套 API Key 调用文本、图像、视频与多模态模型。请求格式尽量保持统一,模型差异通过 model 与各任务参数表达。

当前页面用于完整展示接入结构。正式 Base URL、可用模型 ID 与密钥请以登录后的控制台为准。

鉴权

所有正式请求都需要在 HTTP Header 中携带 Bearer Token。请勿在浏览器前端或公开仓库中暴露 API Key。

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

快速开始

下面以兼容格式发起一次流式文本请求。将控制台提供的 Base URL 和 Key 写入服务端环境变量。

curl "$CHAOSUPER_BASE_URL/chat/completions" \
-H "Authorization: Bearer $CHAOSUPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash", "messages": [{"role":"user","content":"你好"}], "stream": true}'

文本对话

文本模型统一使用消息数组表达上下文。生产环境建议记录 request_id、usage 和 latency,并为超时或限流设置重试与回退。

{ "model": "qwen3.8-max", "messages": [{"role":"system","content":"你是专业助手"},{"role":"user","content":"总结这份材料"}], "temperature": 0.6 }

图像生成

图像任务通常返回任务 ID 或图片资源。不同模型支持的尺寸、参考图数量和编辑参数可能不同。

{ "model": "qwen-image-3.0-pro", "prompt": "高端科技产品发布会主视觉", "size": "1536x1024", "n": 1 }

视频生成

视频任务为异步流程:创建任务后轮询状态,成功后获取结果。时长、清晰度、音频和参考素材会影响价格。

{ "model": "wan3.0-video-prime", "prompt": "夜色中的未来城市,镜头缓慢推进", "duration": 5, "resolution": "1080p" }

错误处理

状态码含义建议
400请求参数错误检查模型 ID 与字段格式
401鉴权失败检查 Key 是否有效
429限流或余额不足降低并发并检查余额
5xx上游或网关异常指数退避重试并保留 request_id