Documentation

一个 API 网关，统一接入主流图像生成模型。智能路由、自动故障转移、统一计费。

1. 认证

在控制台创建 API 令牌（sk-…），并在请求头中以 Bearer Token 携带：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

令牌可绑定模型分组、调用配额和到期时间，也可随时吊销。默认服务地址：https://api.nokyn.com。

2. 服务分组

网关按上游渠道把模型划分为两个服务分组，两组的模型互不混淆。调用都走同一个网关地址 https://api.nokyn.com，差别在于令牌绑定的分组决定你能调用哪一组模型。

调用方式：在控制台创建令牌时选择分组（标准分组 / 企业分组），此后用同一个 /v1/* 端点调用该分组内的模型即可；调用不属于该分组的模型会返回 403 MODEL_NOT_ALLOWED。

下面的调用示例以标准分组的 gpt-image-2.5-flare 与 企业分组的 gemini-3-pro-image-preview-4k 为例，端点与参数格式完全一致。

3. 模型列表

获取当前 Token 可访问的站点模型列表（已按令牌绑定的分组过滤）：

GET /v1/models
GET /v1beta/models

# cURL
curl -X GET "https://api.nokyn.com/v1beta/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "data": [
    { "id": "gemini-3.1-flash-image-preview", "type": "model", "display_name": "Gemini 3.1 Flash Image Preview", "created_at": "..." }
  ]
}

4. 图像生成

4.1 Gemini 风格（推荐图像）

端点：POST /v1beta/models/{model}:generateContent

curl -X POST "https://api.nokyn.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "A banana on fire" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "16:9" }
    }
  }'

响应中的图片位于 candidates[0].content.parts[0].inlineData（base64）。

4.2 OpenAI 风格（文生图 / 图生图）

文生图端点：POST /v1/images/generations；编辑/图生图端点：POST /v1/images/edits

curl -X POST "https://api.nokyn.com/v1/images/generations" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A premium product poster with studio lighting.",
    "n": 1,
    "size": "1536x1024",
    "quality": "xhigh",
    "output_format": "png"
  }'

图生图可传 image[]（multipart 二进制）或 images（JSON 里的 URL / base64 数组）。响应为 OpenAI ImagesResponse 格式，图片在 data[0].b64_json。

企业分组的图像型号（如 gemini-3-pro-image-preview-4k、gemini-3.1-flash-lite-image）使用完全相同的端点与参数格式，只是模型 ID 不同；令牌绑定了「企业分组」即可调用。

5. 模型矩阵

站点已启用以下模型，按服务分组分列（价格为单位成本，实际扣费以此为准）：

6. 计费模式

图像模型按次计费，从账户余额实时扣减：

质量越高、尺寸越大、参考图越多，延迟和成本越高。余额不足时返回 402，配额耗尽返回 403 QUOTA_EXCEEDED。

7. 错误码

8. 通用业务接口

以下接口使用登录会话鉴权（Authorization: Bearer usr_…），在控制台内使用：