接入余岂企业AI服务

使用一把在控制台生成的 API Key，即可调用当前模型广场已上架的文字、图像与视频模型。除 Nano Banana 外，其余本页接口使用 OpenAI 兼容地址；Nano Banana 必须使用下方 Gemini 原生地址。

快速开始

1. 注册并登录 XK 控制台。
2. 进入“令牌”，新建一个 API Key 并立即妥善保存。
3. 在模型广场确认模型名与公开价格。
4. 文字、GPT Image、视频将 Base URL 设为 https://yuqixk.xyz/v1；Nano Banana 使用完整的 https://yuqixk.xyz/v1beta/models/{model}:generateContent。鉴权头均为 Authorization: Bearer YOUR_XK_API_KEY。

复制curl https://yuqixk.xyz/v1/chat/completions \
  -H "Authorization: Bearer $XK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "用三句话介绍企业知识库。"}]
  }'

模型与接口

模型名必须与模型广场一致，大小写、下划线和连字符不可改写。当前 XK 对外启用的模型、价格和可用状态以模型广场实时展示为准。

文字、代码与聊天

Chat Completions 适用于绝大多数聊天、文本生成和代码任务。流式输出时，追加 "stream": true。

复制{
  "model": "gpt-5.6-terra",
  "messages": [
    {"role": "system", "content": "你是企业助理，回答简洁准确。"},
    {"role": "user", "content": "把这段会议纪要整理为待办。"}
  ],
  "stream": false
}

选择建议 sol 适合高质量复杂任务；terra 适合日常生产；luna 适合低成本批量任务。请按模型广场展示的具体价格计费。

代码客户端与 Codex

当前已验证并对外保证的是 /v1/chat/completions。在 IDE、桌面客户端或代码工具中，选择支持 OpenAI-compatible Chat Completions 的自定义 Provider，Base URL 填 https://yuqixk.xyz/v1，模型填写模型广场中的实际名称即可。

部分 Codex 或客户端版本只接受 Responses API，或不允许自定义 Chat Completions Provider；这类版本不能直接套用本页配置。请先以工具自身的 Provider 设置页为准，不要将 XK Key 写入项目配置后提交。

GPT Image 2：生图与参考图编辑

文本生成图片

使用 POST /v1/images/generations。首次接入可先使用已验证的 image2；规格型模型的规格已写在模型名中，不要额外猜测 size 或 quality 参数。

复制curl https://yuqixk.xyz/v1/images/generations \
  -H "Authorization: Bearer $XK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image2",
    "prompt": "一张干净的企业 AI 工作台等距插画，青绿色点缀，白色背景"
  }'

上传参考图进行编辑

使用 multipart 请求 POST /v1/images/edits。服务返回的图片数据或 URL 请由你的应用保存和展示。

复制curl https://yuqixk.xyz/v1/images/edits \
  -H "Authorization: Bearer $XK_API_KEY" \
  -F "model=image2" \
  -F "image=@./reference.png" \
  -F "prompt=保留主体构图，把背景改为简洁的企业办公场景"

Nano Banana 图片生成

Nano Banana 使用 Gemini 原生图片接口，不使用 /v1/images/generations。模型名位于请求 URL 中；分辨率型号仍使用上架的实际名称。

复制curl -X POST "https://yuqixk.xyz/v1beta/models/nano_banana_2:generateContent" \
  -H "Authorization: Bearer $XK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "产品海报：现代企业团队协作，留出标题区域，中文不入图" }]
    }],
    "generationConfig": { "responseModalities": ["IMAGE"] }
  }'

图生图

在同一条 parts 中同时放入图片和文字指令。直接上传 Base64 时使用 inlineData；fileData 需要可访问的 fileUri 与 mimeType，不是普通图片 URL 字符串。

复制{
  "contents": [{"role": "user", "parts": [
    {"inlineData": {"mimeType": "image/png", "data": "BASE64_IMAGE_DATA"}},
    {"text": "保留主体，把背景改为简洁企业办公场景"}
  ]}]
}

生成图片通常在 candidates[].content.parts[].inlineData.data 中返回（Base64）。调用前先在模型广场确认型号仍处于上架状态。

视频模型

视频生成是异步任务。先提交任务，再以返回的 id 轮询进度；成功响应中读取 video_url 或返回的成品 URL。视频时长、分辨率和参考图参数由所选模型决定。

复制curl https://yuqixk.xyz/v1/videos \
  -H "Authorization: Bearer $XK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1-fast",
    "prompt": "镜头缓慢推进，一间明亮的现代办公室，团队正在协作。"
  }'

复制curl "https://yuqixk.xyz/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $XK_API_KEY"

Python 与 OpenAI SDK

复制from openai import OpenAI

client = OpenAI(
    api_key="YOUR_XK_API_KEY",
    base_url="https://yuqixk.xyz/v1",
)

completion = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "写一段产品更新说明。"}],
)
print(completion.choices[0].message.content)

Node.js、Postman、Cherry Studio、LobeChat 等支持 OpenAI 兼容接口的客户端，均使用相同的 Base URL、Bearer Key 与模型名。密钥建议以环境变量或客户端的私密凭据区保存。

错误排查与安全

• 每个应用或环境使用独立 Key，便于随时单独停用。
• 禁止把 Key 放在浏览器前端、移动端安装包、公开仓库和截图中。
• 服务端记录 XK 返回的请求 ID，提交工单时提供请求时间、模型名、接口和请求 ID，不要发送完整 Key。
• 模型、价格和可用状态会调整，生产调用前以模型广场为准。

余岂企业AI服务 XK 开发者文档。本文档仅对应 https://yuqixk.xyz，不关联其他站点或账户。