开发者开放平台

把 AI 生成能力接到你的程序里

通过一枚 sk- API Key,调用 Gemini 3 文本/思考、Nano Banana 图片、Wan 2.7 图片三类上游 AI 模型。CNY 计费,按量结算,失败全额退款。

立即创建 API Key 查看接口

🚀 三步接入

  1. 登录并创建 Key
    前往 账户中心 → "API 密钥" 卡片,点"创建 Key",复制形如 sk-xxxxxxxxxxx 的明文。 ⚠ 明文只显示一次,请立即保存到服务端配置。
  2. 充值 CNY 积分
    在账户中心"积分"面板充值(1 积分 = 1 分 = 0.01 元)。每次调用前会先冻结预估金额,任务结束按实际用量结算并返还差额。
  3. 带着 Key 发起请求
    Base URL:https://www.jlike.com,在 HTTP 头加上 Authorization: Bearer sk-xxx 即可。

准备好了吗?

打开账户中心,一分钟内拿到你的第一枚 Key。

前往创建 API Key

🔐 鉴权与计费

请求头

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
  • Key 被吊销 / 不存在 → HTTP 401
  • Key 有效但余额不足 → HTTP 402
  • 触发每用户速率限制 → HTTP 429

计费模型

  • 货币:CNY(人民币),单位为元,保留 4 位小数
  • 全局加价倍率:MARKUP = 1.3(即上游原价 × 1.3)
  • 文本(Gemini 3):按响应中的 promptTokenCount + candidatesTokenCount + thoughtsTokenCount 实际 token 计费
  • 图片(Nano Banana / Wan 2.7):按实际成功返回的图片张数 × 模型 size 单价计费
  • 提交时 冻结 预估上限 → 任务结束按实际用量 结算并返还差额 → 失败 全额退款

📡 三个接口

POST/api/v1/openapi/gemini3/generate

Gemini 3 文本 / 思考生成。透传 contents / generationConfig / tools / systemInstruction,响应附加 _billing 字段。

model说明
gemini-3.1-pro-preview最强,慢
gemini-3-flash-preview平衡
gemini-3.1-flash-lite-preview最便宜,最快
curl -X POST https://www.jlike.com/api/v1/openapi/gemini3/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash-preview",
    "contents": [{"role":"user","parts":[{"text":"用一句话解释相对论"}]}]
  }'

POST/api/v1/openapi/nanobanana/generate

Nano Banana 图片生成(Google 原生图模型)。同步返回,base64 PNG。

别名上游模型
nano-bananagemini-2.5-flash-image
nano-banana-2gemini-3.1-flash-image-preview
nano-banana-progemini-3-pro-image-preview

size512 / 1K / 2K / 4Kaspect_ratio1:1 / 16:9 / 9:16 / 4:3 / 3:4

curl -X POST https://www.jlike.com/api/v1/openapi/nanobanana/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "赛博朋克风格的猫,霓虹灯招牌下",
    "size": "2K",
    "aspect_ratio": "16:9",
    "n": 1
  }'

POST/api/v1/openapi/wan27/generate
GET/api/v1/openapi/wan27/task/{task_uuid}

Wan 2.7 图片生成(异步)。提交后立即返回 task_uuid,建议每 3–5 秒轮询一次。终态结果会缓存到 DB,重复查询不会二次扣费。失败自动全额退款。

# 提交
curl -X POST https://www.jlike.com/api/v1/openapi/wan27/generate \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-t2i-plus","prompt":"astronaut on mars","size":"2K","aspect_ratio":"16:9","n":1}'

# 轮询
curl https://www.jlike.com/api/v1/openapi/wan27/task/<task_uuid> \
  -H "Authorization: Bearer sk-xxxxxxxx"

⚠ Wan 返回的图片 URL 由上游签发,有效期通常 24 小时,请尽快下载到自己的存储。

⚠ 错误码

HTTP场景
400请求体非法(model 不支持、必填字段缺失等)
401API Key 无效 / 已吊销
402积分不足
429速率限制
502上游返回错误
503服务未开放 / 上游 Key 未配置
504上游超时

失败响应统一格式:

{
  "success": false,
  "error": "错误描述",
  "error_code": "INVALID_PARAMS"
}

✅ 最佳实践