
关键词:StepFun API教程、阶跃星辰API调用、Step-3.5-flash使用、AI大模型接入、Python调用大模型、curl调用AI接口

最近在做AI项目选型时,我发现不少开发者只知道OpenAI接口,其实国内也有很多可直接接入的大模型平台。 这篇文章手把手带你从0到1接入 StepFun 大模型 API,包括:
看完即可直接在项目中落地。
官方提供了完整文档索引入口:
https://platform.stepfun.com/docs/llms.txt这个文件可以用于自动化检索所有文档页面,在做SDK或工具封装时非常实用。
进入开放平台 → 账号管理 → 接口密钥:
https://platform.stepfun.com/interface-key
创建后即可获得:
STEP_API_KEY后续所有请求均通过该 Key 鉴权。
StepFun 接口兼容 OpenAI SDK,直接安装即可:
pip install --upgrade 'openai>=1.0'这点非常关键: 意味着你已有的 OpenAI 代码几乎可以零成本迁移。
sudo apt-get update
sudo apt-get install curlsudo yum install curlCentOS 8+
sudo dnf install curlbrew install curl接下来开始正式调用模型:step-3.5-flash
from openai import OpenAI
client = OpenAI(
api_key="STEP_API_KEY",
base_url="https://api.stepfun.com/v1"
)
completion = client.chat.completions.create(
model="step-3.5-flash",
messages=[
{
"role": "system",
"content": "你是由阶跃星辰提供的AI聊天助手,你擅长中文,英文,以及多种其他语言的对话。在保证用户数据安全的前提下,你能对用户的问题和请求,作出快速和精准的回答。同时,你的回答和建议应该拒绝黄赌毒,暴力恐怖主义的内容",
},
{
"role": "user",
"content": "你好,请介绍一下阶跃星辰的人工智能!"
},
],
)
print(completion)参数 | 说明 |
|---|---|
base_url | 指向 StepFun API |
model | 使用 step-3.5-flash |
messages | 完全兼容 OpenAI Chat 格式 |
这意味着你可以一行代码切换模型提供商。
curl https://api.stepfun.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $STEP_API_KEY" \
-d '{
"model": "step-3.5-flash",
"messages": [
{
"role": "system",
"content": "你是由阶跃星辰提供的AI聊天助手..."
},
{
"role": "user",
"content": "你好,请介绍一下阶跃星辰的人工智能!"
}
]
}'适合:
StepFun 支持 非流式 和 流式 stream 两种返回方式。
{
"id": "4e38135e3515f98a03d51e852cc55003",
"object": "chat.completion",
"model": "step-3.5-flash",
"choices": [
{
"message": {
"role": "assistant",
"content": "阶跃星辰是一家专注于多模态人工智能技术研发的科技公司..."
}
}
],
"usage": {
"prompt_tokens": 85,
"completion_tokens": 340,
"total_tokens": 425
}
}字段 | 作用 |
|---|---|
choices.message.content | 模型回答 |
usage | token消耗统计 |
finish_reason | 停止原因 |
流式返回采用 SSE格式:
data: {...chunk1}
data: {...chunk2}
data: {...chunk3}
data: [DONE]流式特点:
前端通常使用:
EventSource / fetch stream / WebSocket来逐块拼接内容。
最大请求时间:
10分钟超时返回:
HTTP 503适用于:
如果请求过于频繁:
HTTP 429 Too Many Requests解决方案:
StepFun 的特点非常明显:
对于已有 AI 项目的开发者来说:
基本只需要修改 base_url 即可完成迁移。
如果你正在开发 AI 应用、智能客服、写作工具、Agent 或聊天产品,这套接口可以直接投入生产使用。