OpenAI兼容 API
从环境变量到第一条请求

一、接入前准备

开始之前，准备好登录控制台中的三项信息：API Base URL、访问凭证和可用模型名。不要把访问凭证写进浏览器端、公开仓库或会被提交到版本控制的配置文件。

二、发送第一条请求

以下示例使用常见的聊天补全格式。把占位符替换为登录控制台中的实际值后，再在服务端执行。

curl "$API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [
      {"role": "user", "content": "你好，云祥API"}
    ]
  }'

如果接口返回成功，再把同样的配置放进你的 SDK 或后端服务中。模型字段、流式响应、图像输入等能力，可能需要参考对应模型的独立说明。

三、常见错误排查

四、API Key 安全建议

API Key 应当只出现在服务端或受控的运行环境中。生产项目建议使用环境变量或密钥管理服务，并为不同项目设置不同凭证；发现泄露后及时在登录控制台撤销并重新创建。