跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
背景必读

特点：本分组为内测，可输出的图片为 URL 地址，而非 Base64，可减轻 Base64 传输压力，提升客户体验。适合直接用 URL 的场景。如果没有特别需求、能处理 Base64 输出的图片格式，则仍然建议使用「正常默认分组」或「NanoBanana 企业分组」。
支持模型（Nano Banana Pro 和第一代）：
  • gemini-3-pro-image-preview
  • gemini-3.1-flash-image-preview
  • gemini-2.5-flash-image

​
如何开始

1

联系管理员开通该可见分组

联系管理员为你的账号开通 NB-OSS 可见分组（在「编辑用户信息 → 额外可见分组」中添加 NB-OSS）。
编辑用户信息界面，在额外可见分组中添加 NB-OSS 分组
2

新建令牌：选择 NB-OSS 分组

新建令牌时，计费模式选「按次计费」，分组选 NB-OSS（Nano Banana PRO，输出图片为 URL，替代 Base64）。只换令牌，请求方式不变。
创建令牌界面：计费模式选择按次计费，选择分组 NB-OSS，输出图片为 URL 替代 Base64
3

替换令牌，进行测试

替换令牌进行测试。代码层面需要兼容 URL 输出的解析 —— 不要直接替换 Base64，两者兼容最佳。

​
示例代码

curl --location 'https://api.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent' \
  --header 'Authorization: Bearer sk-' \
  --header 'Content-Type: application/json' \
  --data '{
      "contents": [
          {
              "parts": [
                  {
                      "fileData": {
                          "fileUri": "https://raw.githubusercontent.com/apiyi-api/ai-api-code-samples/refs/heads/main/Vision-API-OpenAI/otter.png",
                          "mimeType": "image/png"
                      }
                  },
                  {
                      "text": "add five dogs"
                  }
              ],
              "role": "user"
          }
      ],
      "generationConfig": {"responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }},
      "safetySettings": []
  }'   > output.json

​
输出示例

在 text 字段里有图片的地址，下方的 thoughtSignature 是推理过程的 base64。
API 响应 JSON 示例，text 字段包含图片 URL 地址，thoughtSignature 字段为推理的 base64

​
网址打不开？

核心是把输出内容 JSON 里的转义字符 \u0026 还原成正常的 &，同时忽略 thoughtSignature 后面的 base64 内容。
说明图：图片链接在 text 字段，需将 JSON 转义符 反斜杠 u0026 还原成 & 号，忽略 thoughtSignature 后的 base64 内容