API 参考

Base URL https://api.genmux.tech。所有请求和响应都是 JSON。每个请求都需要 API 密钥。

快速开始

在控制台创建密钥并导出它，然后照下面的命令原样运行。

export API_KEY=nb_live_...   # from Dashboard → API keys

1. 提交一次生成

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"nanobanana","prompt":"a red fox in snow","resolution":"1K","ratio":"1:1"}'

Response · 202 Accepted

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "queued",
  "params": {"prompt": "a red fox in snow", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 2,
  "created_at": "2026-08-28T20:01:12.345Z"
}

2. 轮询直到 status = succeeded（通常 1–20 秒）

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

Response · 200 OK

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "succeeded",
  "params": {"prompt": "a red fox in snow", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 2,
  "images": [
    {
      "index": 0,
      "url": "https://…/0.png?X-Amz-Expires=900&…",
      "expires_at": "2026-08-28T20:16:30Z",
      "mime": "image/png",
      "width": 1024,
      "height": 1024,
      "bytes": 1843201,
      "sha256": "9f2c…"
    }
  ],
  "created_at": "2026-08-28T20:01:12.345Z",
  "finished_at": "2026-08-28T20:01:19.802Z"
}

3. 下载图片（URL 有效期 15 分钟）

curl -s -o fox.png "https://…/0.png?X-Amz-Expires=900&…"

认证

把密钥作为 bearer token 发送。密钥以 nb_live_ 开头，创建时只展示一次，可在控制台轮换或吊销。

Authorization: Bearer $API_KEY

每把密钥可选配置 IP 白名单：来自其他地址的请求会收到 403 ip_not_allowed.