Step 5 Preview API 上手：密钥、文本对话与图/视频理解
按阶跃星辰（StepFun）官方文档，用 OpenAI Python SDK / cURL 调用 step-5-preview：拿密钥、发文本对话、再做 image_url / video_url 多模态理解。含可抄代码与对照结果。
入门·2 课时·45 分钟·图文实操
免费学习无需登录
你将学会
- 确认模型 ID step-5-preview 与 API Base https://api.stepfun.ai/v1
- 用 OpenAI Python SDK 与 cURL 发出文本对话
- 用 image_url / video_url 做图片与视频理解
- 从 choices[0].message.content 读取正文并对照官方限制与标价
适合谁
- 想调用阶跃星辰 Step 5 Preview API 的开发者
- 会基础 Python 或 cURL、需要可跟做多模态示例的同学
课前准备
- 可登录 StepFun Open Platform 并创建 API Key
- 本机有 Python 3（可安装 openai>=1.0）或 curl
课程目录
2 课时 · 45 分钟课程说明
Step 5 Preview API 上手：密钥、文本对话与图/视频理解
本课按阶跃星辰（StepFun）官方文档整理，目标是：从零配置密钥，用 OpenAI 兼容接口端到端调用
step-5-preview——先跑通文本对话，再完成图片与视频理解。
主要来源：Quickstart · Step 5 Preview · Pricing · 产品页
你将得到什么
- 正确的模型 ID 与 API Base：
step-5-preview+https://api.stepfun.ai/v1 - 可复制的 Python（OpenAI SDK）与 cURL：文本 /
image_url/video_url - 成功时从
choices[0].message.content读正文的习惯 - 官方格式与限制对照（图片最多 60 张；视频 MP4 建议 <128MB、<5 分钟）以及当前标价
课前准备
- 登录 StepFun Open Platform，在 Interface Keys 创建 API Key（文中占位符为
YOUR_STEP_API_KEY）。 - 本机有 Python 3（将安装
openai>=1.0）或curl。 - 第二课时需要你自己可公网访问的图片/视频直链（不要直接用文档里的
example.com占位）。
课程结构（2 课时）
- 拿密钥并发出第一次文本对话（
api-key-text-chat）
安装 SDK → Python / cURL 调用step-5-preview→ 核对响应形状与定价表。 - 图片与视频理解（
image-video-understanding）
image_url/video_url多模态请求；替换为自己的可达 URL；对照格式与大小限制。
模型速览（官方核验）
| 项 | 值 |
|---|---|
| Model ID | step-5-preview |
| 架构（产品页） | 600B MoE / 约 27B 激活 |
| 上下文 | 1M tokens |
| 输入 | 文本、图片、视频 |
| 开源权重 | 产品页：计划 2026-10-15 开放 |
| 定价（/1M tokens） | 输入 cache-miss $1.00 · cache-hit $0.10 · 输出 $2.70 |
跟做时请始终以官方文档为准；密钥勿提交到公开仓库。