星渡开发文档

开发文档

星渡开放平台的 API 接入说明与服务指南。

开始使用星渡

星渡提供兼容 OpenAI 格式的 API 接入。创建 API Key 后,把客户端的 Base URL 指向星渡即可调用。

接入地址

https://xindu.xyz/v1

创建密钥

  1. 登录星渡控制台。
  2. 进入 API Keys。
  3. 创建密钥并选择可用分组。
  4. 保存后立即复制密钥。完整密钥只显示一次。

2.8.2 的一把 API Key 绑定一个分组。不同分组的模型权限和倍率可能不同;请到模型广场查看当前配置。

Responses

适合 Agent 工作流、工具调用和多模态输入。

curl https://xindu.xyz/v1/responses -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "model": "YOUR_AVAILABLE_MODEL",
  "input": "用三句话解释什么是二分查找"
}'

Chat Completions

curl https://xindu.xyz/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "model": "YOUR_AVAILABLE_MODEL",
  "messages": [{"role": "user", "content": "写一个 Python 快速排序示例"}]
}'

Python SDK

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://xindu.xyz/v1")
response = client.responses.create(
    model="YOUR_AVAILABLE_MODEL",
    input="解释一下二分查找",
)
print(response.output_text)

费用与用量

实际可用模型、倍率和价格以模型广场与控制台当前分组配置为准。建议为不同业务创建独立密钥,便于审计和额度管理。

更多接口

On this page