跳转到主要内容
Starrise AI 提供统一的 API 来访问多个供应商的 AI 模型 — 包括对话、图片生成、视频生成和音频。本指南带您完成首次 API 调用。

​
前置条件

​
第一步：创建账户

  1. 打开 Starrise AI 控制台 https://ai.starrise.tech
  2. 使用邮箱或 OAuth（GitHub、Discord 等）注册
  3. 新用户注册后可能获得赠送额度（以账户页面显示为准）

​
第二步：创建 API 密钥

  1. 登录控制台，打开 令牌 页面
  2. 点击 创建令牌
  3. 填写名称，按需设置配额、过期时间等
  4. 提交后在列表中 复制 Key，格式为 sk-...
完整 Key 仅显示一次，请妥善保存。

​
第三步：发起第一次请求

使用您的 API 密钥调用对话模型。将 YOUR_API_KEY 替换为实际令牌： 
curl https://ai.starrise.tech/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "你好！" }
    ]
  }'
响应示例： 
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！有什么我可以帮助你的吗？"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 12,
    "total_tokens": 22
  }
}

​
使用 SDK

​
Python

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://ai.starrise.tech/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好！"}]
)

print(response.choices[0].message.content)

​
Node.js

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://ai.starrise.tech/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好！" }],
});

console.log(response.choices[0].message.content);

​
流式输出

设置 "stream": true 以接收 Server-Sent Events (SSE) 流式数据块： 
stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "讲一个故事"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

​
错误处理

状态码说明
200成功
400请求错误 — 无效参数
401未授权 — API 密钥无效或缺失
403禁止访问 — 权限不足或模型受限
404未找到 — 无效的端点或模型
429速率限制 — 请求过于频繁
500服务器内部错误
发生错误时，API 返回包含 error 对象的 JSON 响应： 
{
  "error": {
    "message": "提供的 API 密钥无效。",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

​
下一步