快速开始：从零到第一个成功请求

前置条件

已注册星战科技账号，并开通智连 OpenAPI；在控制台创建应用，获取 API Key。

调用端可访问 https://openapi.xingzhan.cloud；代码中通过环境变量注入 Key，不要硬编码或提交到仓库。

三步接入

智连兼容主流接口形态，迁移时通常只需要替换 base_url，其余调用代码保持不变。

• 替换 base_url：https://openapi.xingzhan.cloud
• 创建应用并获取 API Key
• 调用一次 /v1/chat/completions，确认模型、计费与配额

最小可运行示例

把下面的示例保存为 shell 脚本，替换 $XINGZHAN_API_KEY 后执行。

curl https://openapi.xingzhan.cloud/v1/chat/completions \
  -H "Authorization: Bearer $XINGZHAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'

参数与错误处理

model 指定控制台模型目录中的模型 ID；messages 使用主流 chat 格式；具体上下文与单价以控制台实时目录为准。

• 401：Key 无效或未注入，检查环境变量与请求头
• 429：触发限流或配额，查看项目配额与重试策略
• 5xx：上游或路由异常，按指数退避重试并保留 request id