跳转到主要内容

申请API密钥

你可以在开放平台账号管理子菜单接口密钥中获取API密钥

环境准备

Python依赖安装

对 python 用户,可以复用 openai 的 sdk
pip install --upgrade 'openai>=1.0'

cURL环境安装

在不同的操作系统上安装curl命令,会使用不同的包管理器。以下是在Debian、CentOS和macOS上安装curl的命令:
  1. Debian/Ubuntu (使用apt包管理器):
    sudo apt-get update
    sudo apt-get install curl
    
  2. CentOS (使用yumdnf包管理器, CentOS 8 或更高版本使用dnf):
    • 使用yum:
    sudo yum install curl
    
    • 使用dnf(CentOS 8):
    sudo dnf install curl
    
  3. macOS (使用brew包管理器, 如果尚未安装Homebrew,可以参考Homebrew官网进行安装):
    brew install curl
    

发送请求

在安装好环境依赖并申请了API密钥之后,可以使用python库或者curl发送请求。下列是简单的python以及curl示例:
copy
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)

响应请求

stream和非stream返回类似如下:
copy
{
    "id": "4e38135e3515f98a03d51e852cc55003.1e6b4aa12e23140c302a217c50085b77",
    "object": "chat.completion",
    "created": 1772613689,
    "model": "step-3.5-flash",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "阶跃星辰是一家专注于多模态人工智能技术研发的科技公司,致力于提供安全、可靠且具有国际视野的AI助手服务。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 85,
        "completion_tokens": 340,
    "total_tokens": 425
    }
}
部分异常响应如下(详细错误信息可以参考错误码文档):
  • 请求超时机制:我们为每个请求设定了一个时间限制,即10分钟。如果在这个时间限制内请求没有完成,系统将不会继续等待,而是立即终止该请求,并返回一个状态码为503的错误响应。
  • 速率限制:系统还设置了速率限制来控制请求的频率。如果用户的请求频率超过了这个限制,系统将不会处理超出限制的请求,而是直接返回一个状态码为429的错误响应。这个错误表示“太多请求”,意味着用户在给定的时间窗口内发送了太多的请求。