AI 图像生成 API

Authorization: Bearer sk-nb-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

复制

# 1. 提交生图任务
curl -X POST /openapi/v1/images/generate \
  -H "Authorization: Bearer sk-nb-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cute cat sitting on a cloud"}'

# 2. 轮询任务状态（替换 TASK_ID）
curl /openapi/v1/images/TASK_ID \
  -H "Authorization: Bearer sk-nb-YOUR_KEY"

import requests, time

BASE = ""
KEY  = "sk-nb-YOUR_KEY"
HEADERS = {"Authorization": f"Bearer {KEY}"}

# 1. 提交任务
resp = requests.post(f"{BASE}/openapi/v1/images/generate",
    headers=HEADERS,
    json={"prompt": "a cute cat sitting on a cloud"})
task_id = resp.json()["task_id"]

# 2. 轮询结果
while True:
    r = requests.get(f"{BASE}/openapi/v1/images/{task_id}", headers=HEADERS)
    data = r.json()
    if data["status"] == "completed":
        print("图片 URL:", data["image"]["url"])
        break
    elif data["status"] == "failed":
        print("生成失败:", data.get("error"))
        break
    time.sleep(2)

const BASE = "";
const KEY  = "sk-nb-YOUR_KEY";
const headers = { "Authorization": `Bearer ${KEY}`, "Content-Type": "application/json" };

// 1. 提交任务
const res = await fetch(`${BASE}/openapi/v1/images/generate`, {
  method: "POST", headers,
  body: JSON.stringify({ prompt: "a cute cat sitting on a cloud" })
});
const { task_id } = await res.json();

// 2. 轮询结果
async function poll(taskId) {
  while (true) {
    const r = await fetch(`${BASE}/openapi/v1/images/${taskId}`, { headers });
    const data = await r.json();
    if (data.status === "completed") return data.image.url;
    if (data.status === "failed") throw new Error(data.error);
    await new Promise(r => setTimeout(r, 2000));
  }
}
const imageUrl = await poll(task_id);
console.log("图片 URL:", imageUrl);

{
  "success": true,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "credits_remaining": 42
}

复制

curl -X POST /openapi/v1/images/generate \
  -H "Authorization: Bearer sk-nb-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a futuristic city at night, neon lights",
    "model": "nano-banana-pro",
    "aspect_ratio": "16:9"
  }'

import requests

resp = requests.post(
    "/openapi/v1/images/generate",
    headers={"Authorization": "Bearer sk-nb-YOUR_KEY"},
    json={
        "prompt": "a futuristic city at night, neon lights",
        "model": "nano-banana-pro",
        "aspect_ratio": "16:9"
    }
)
print(resp.json())

const resp = await fetch("/openapi/v1/images/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-nb-YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "a futuristic city at night, neon lights",
    model: "nano-banana-pro",
    aspect_ratio: "16:9"
  })
});
console.log(await resp.json());

{
  "success": true,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "credits_remaining": 36
}

复制

curl -X POST /openapi/v1/images/edit \
  -H "Authorization: Bearer sk-nb-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "将图片转换为水彩画风格",
    "reference_image_url": "https://example.com/your-image.jpg",
    "model": "nano-banana-pro"
  }'

import requests, time

BASE = ""
KEY  = "sk-nb-YOUR_KEY"
HEADERS = {"Authorization": f"Bearer {KEY}"}

resp = requests.post(f"{BASE}/openapi/v1/images/edit",
    headers=HEADERS,
    json={
        "prompt": "将图片转换为水彩画风格",
        "reference_image_url": "https://example.com/your-image.jpg",
        "model": "nano-banana-pro"
    })
task_id = resp.json()["task_id"]

# 轮询结果
while True:
    r = requests.get(f"{BASE}/openapi/v1/images/{task_id}", headers=HEADERS)
    data = r.json()
    if data["status"] == "completed":
        print("图片 URL:", data["image"]["url"])
        break
    elif data["status"] == "failed":
        print("失败:", data.get("error"))
        break
    time.sleep(2)

const BASE = "";
const KEY  = "sk-nb-YOUR_KEY";
const headers = { "Authorization": `Bearer ${KEY}`, "Content-Type": "application/json" };

const res = await fetch(`${BASE}/openapi/v1/images/edit`, {
  method: "POST", headers,
  body: JSON.stringify({
    prompt: "将图片转换为水彩画风格",
    reference_image_url: "https://example.com/your-image.jpg",
    model: "nano-banana-pro"
  })
});
const { task_id } = await res.json();

// 轮询结果（同文生图）
while (true) {
  await new Promise(r => setTimeout(r, 2000));
  const s = await (await fetch(`${BASE}/openapi/v1/images/${task_id}`, { headers })).json();
  if (s.status === "completed") { console.log(s.image.url); break; }
  if (s.status === "failed") { console.error(s.error); break; }
}

{ "status": "generating" }

{
  "status": "completed",
  "image": {
    "id": 1234,
    "url": "https://example.com/uploads/xxx.png",
    "prompt": "a cute cat sitting on a cloud",
    "model": "nano-banana-pro"
  }
}

{ "status": "failed", "error": "模型调用超时" }

{
  "success": true,
  "models": [
    {
      "model_id": "nano-banana-pro",
      "display_name": "Nano Banana Pro",
      "credit_cost": 6,
      "supported_sizes": "1K,2K,4K",
      "description": "高质量文生图模型"
    }
  ]
}

{ "success": true, "credits": 88 }