Documentation

一个 API 网关，统一接入图像、视频与对话模型。智能路由、自动故障转移、统一计费。

1. 认证

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

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

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

2. 模型列表

获取当前 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-2.5-flash-image", "type": "model", "display_name": "Gemini 2.5 Flash Image", "created_at": "..." }
  ]
}

3. 图像生成

3.1 Gemini 风格（推荐图像）

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

curl -X POST "https://api.nokyn.com/v1beta/models/gemini-2.5-flash-image: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）。

3.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。

4. 对话（OpenAI 兼容）

端点：POST /v1/chat/completions

curl -X POST "https://api.nokyn.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

可用模型：gemini-llm、claude-3-7-sonnet、openai-llm、deepseek-chat、qwen-max。

5. 视频生成

端点：POST /v1beta/models/{model}:generateContent（sora-2、veo-3.1、kling-3.0、seedance-2.0）

curl -X POST "https://api.nokyn.com/v1beta/models/sora-2:generateContent" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "A cinematic drone shot over a neon city at night" }] }]
  }'

6. 模型矩阵

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

7. 计费模式

计费由三部分组成，按模型单位价格从账户余额实时扣减：

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

8. 错误码

9. 通用业务接口

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