请输入
菜单

📘 API 接口总览与认证

📘 API 接口总览与认证

这篇是给开发者看的接口总览。如果你只是配置 OpenClaw、Codex、VS Code 或 Claude Code，可以先看对应软件教程；如果你要自己写代码调用像素群岛 API，就从这里开始。

1. 三个常用 Base URL

用途 Base URL 说明
文本对话、代码、OpenAI 兼容工具 https://api.shiyutv.cn/v1 最常用，适合 Chat Completions、Responses、Models 等 OpenAI 兼容接口。
生图、改图 https://api-img.shiyutv.cn/v1 图片模型专用，推荐用于 gpt-image-2 等图片生成/改图任务。
Google Gemini 官方格式 https://api.shiyutv.cn/v1beta 适合需要 Gemini 官方兼容格式的客户端。

2. 认证方式

所有 API 请求都需要携带 API Key。进入像素群岛后台，打开「API 密钥」，创建或复制密钥。

请求头写法：

http 复制代码 
Authorization: Bearer 你的_API_Key
Content-Type: application/json

注意：

  • API Key 只复制一次完整内容，前后不要带空格。
  • 不要把完整 API Key 发给别人，也不要贴到公开截图里。
  • 如果密钥被泄露，建议立刻在后台禁用旧密钥，并创建新密钥。

3. 常用接口

场景 方法 路径
查看可用模型 GET /models
文本对话 POST /chat/completions
Responses API POST /responses
图片生成 POST https://api-img.shiyutv.cn/v1/images/generations

4. 最小测试请求

bash 复制代码 
curl https://api.shiyutv.cn/v1/chat/completions \
  -H "Authorization: Bearer 你的_API_Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "你好，请只回复：测试成功"}
    ]
  }'

如果返回 401，优先检查 API Key；如果返回 404 或 model not found，优先检查模型名称是否和后台「可用渠道」一致。

5. 选择哪个接口

需求 推荐接口
普通聊天、代码助手、翻译、摘要 Chat Completions
OpenAI SDK 默认调用 Chat Completions
需要 Responses 格式、工具调用、多轮 response id Responses API
生图、改图、参考图生成 图片生成 API
只想看自己能用哪些模型 Models API
最近修改: 2026-05-17Powered by