常见问题

花椰菜是 OpenAI 兼容的大模型 API 网关。官方站点 https://xshell.club。

花椰菜是什么？

一个 Base URL、一把 API Key，调用对话、图像生成和视频生成。机器可读说明见 llms.txt 与 OpenAPI。

官方 Base URL 是什么？

站点是 https://xshell.club。OpenAI SDK 把 base_url 设为 https://xshell.club/v1。Gemini 形态的探测前缀是 https://xshell.club/v1beta。

如何鉴权？

• Authorization: Bearer <API_KEY>
• x-api-key: <API_KEY>
• x-goog-api-key: <API_KEY>

Key 在 注册 并登录控制台后创建。

支持哪些接口？

• 对话：POST /v1/chat/completions（说明）
• Responses：POST /v1/responses
• 生图：POST /v1/images/generations、POST /v1/images/edits（说明）
• 视频：POST /v1/videos/generations（说明）
• 向量：POST /v1/embeddings
• Anthropic Messages：POST /v1/messages
• Gemini 形态：/v1beta

模型 ID 从哪里获取？

不要猜模型名。用 Key 请求 GET /v1/models，以返回的 id 为准。

没有 Key 或 Key 错误会返回什么？

没有 Key：HTTP 401，API_KEY_REQUIRED。错误 Key：HTTP 401，INVALID_API_KEY。详见 鉴权。

用 GET 调用对话接口可以吗？

不可以。对话、生图、图像编辑、向量和 Messages 只接受 POST。GET 返回 HTTP 405，并带 Allow: POST, OPTIONS。浏览器 OPTIONS 预检返回 204。

支持语音合成吗？

不支持。/v1/audio/speech 当前返回 404。

如何从 OpenAI 官方 SDK 迁过来？

保留原来的调用代码，只改 base_url 和 api_key，model 改成 GET /v1/models 返回的 ID。

from openai import OpenAI
client = OpenAI(api_key="sk-YOUR-KEY", base_url="https://xshell.club/v1")
print(client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "你好，花椰菜"}],
).choices[0].message.content)

价格在哪里看？

按控制台账户余额计费。公开页面不列举未核实的单价。摘要见 定价，具体档位以登录后的控制台为准。

生图多少钱？

按张计费：1K ¥1.20、2K ¥1.60、4K ¥2.40。改图与文生图同价，生成失败不计费。网页入口是 无限画布，打开即自动配好线路和密钥；尺寸细节见 图像生成文档。

怎么确认网关在线？

GET https://xshell.club/health 不需要 Key。返回 JSON 里 status 为 ok，name 为花椰菜。