开发者接入与请求示例

已有应用的用户优先看应用接入。 本页适合写脚本、接 SDK，或想绕过客户端检查配置的用户。

地址与协议

协议 / 用途	方法	完整请求地址
获取可用模型	GET	https://v1.123336.xyz/v1/models
OpenAI Responses	POST	https://v1.123336.xyz/v1/responses
OpenAI Chat Completions	POST	https://v1.123336.xyz/v1/chat/completions
Anthropic Messages	POST	https://v1.123336.xyz/v1/messages
Gemini 原生	POST	https://v1.123336.xyz/v1beta/models/{model}:generateContent

SDK 的 base_url 通常填写 https://v1.123336.xyz/v1；Claude Code 填根地址 https://v1.123336.xyz。备用域名为 api.123336.xyz，路径保持不变。

接口列表来自本站公开的模型广场配置；支持哪种协议，要同时看具体模型及客户端。协议兼容不等于完整支持官方全部工具、托管文件、对话存储或后台任务。

准备环境变量

使用创建的模型 API 密钥，不是面板访问令牌。以下变量仅作用于当前终端：

Bash

read -r -s -p 'ST API Key: ' ST_API_KEY; echo
export ST_API_KEY
export ST_API_BASE_URL="https://v1.123336.xyz/v1"
export ST_MODEL="gpt-6-astra"

PowerShell 7

$env:ST_API_KEY = Read-Host 'ST API Key' -MaskInput
$env:ST_API_BASE_URL = 'https://v1.123336.xyz/v1'
$env:ST_MODEL = 'gpt-6-astra'

ST_MODEL 要改成该密钥分组下的模型 ID。如果你使用 Windows PowerShell 5.1，可用下面 Python 示例的隐藏输入方式，或先安装 PowerShell 7。

获取可用模型

这个请求只获取列表，不生成内容，适合先检查地址与鉴权。

Bash / Zsh

curl --fail-with-body "$ST_API_BASE_URL/models" \
  -H "Authorization: Bearer $ST_API_KEY"

PowerShell

Invoke-RestMethod -Uri "$env:ST_API_BASE_URL/models" `
  -Headers @{ Authorization = "Bearer $env:ST_API_KEY" }

成功时会得到 data 列表，模型 ID 在各项的 id 字段里。如果列表不含目标模型，先核对密钥分组，不要反复尝试猜模型名。

发送第一条 Responses 请求

下面的请求会产生模型调用费用。先用短输入测试；示例模型需在密钥分组中可用。

Bash / Zsh

curl --fail-with-body "$ST_API_BASE_URL/responses" \
  -H "Authorization: Bearer $ST_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ST_MODEL\",\"input\":\"Reply with OK.\",\"stream\":false}"

PowerShell

$body = @{
  model = $env:ST_MODEL
  input = 'Reply with OK.'
  stream = $false
} | ConvertTo-Json

Invoke-RestMethod -Method Post -Uri "$env:ST_API_BASE_URL/responses" `
  -Headers @{ Authorization = "Bearer $env:ST_API_KEY" } `
  -ContentType 'application/json' -Body $body

Python SDK

安装 SDK：python -m pip install openai。脚本优先读上面的环境变量；未设置密钥时会提示隐藏输入，不把密钥写进源码：

import os
from getpass import getpass
from openai import OpenAI

api_key = os.environ.get("ST_API_KEY") or getpass("ST API Key: ")
client = OpenAI(
    api_key=api_key,
    base_url=os.environ.get("ST_API_BASE_URL", "https://v1.123336.xyz/v1"),
    max_retries=0,  # 首次排查先关闭自动重试，便于核对单次请求
)

response = client.responses.create(
    model=os.environ.get("ST_MODEL", "gpt-6-astra"),
    input="Reply with OK.",
)
print(response.output_text)

OpenAI SDK 的接口格式参考官方快速开始；本站模型、价格与可用功能以本站配置为准。

Chat Completions 与流式响应

老客户端可能使用 Chat Completions，请把正文改成 messages，而不是 input：

{
  "model": "gpt-6-astra",
  "messages": [{ "role": "user", "content": "Reply with OK." }],
  "stream": false
}

发送到 /v1/chat/completions。需要流式输出时设置 stream: true，并由客户端按对应协议解析事件；curl 可加 -N 禁用输出缓冲。

HTTP 200 只说明请求开始返回，不保证流式输出完整结束。 如果中途断流、没有最终结果或工具调用未完成，请保留请求 ID，结合使用日志排查。不要只凭首个状态码把整次任务判为成功。

出错先查什么

按「地址 → 密钥 → 分组 → 模型 ID → 协议 → 额外参数」逐项检查。GET /models 能成功，但生成失败时，重点检查该模型的渠道状态、参数与额度，详见常见问题。