包菜大王

外观

快速开始 ​

Base URL： https://api.713812.xyz
鉴权： Authorization: Bearer YOUR_API_KEY
把 YOUR_API_KEY 换成 控制台 发放的密钥。

建议超时：图像 1K/2K ≥ 120s；4K ≥ 180–300s。

1. 查询可用模型 ​

bash
curl -sS https://api.713812.xyz/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

图像相关示例模型 ID（以控制台实际开通为准）：

  • gpt-image-2 / gpt-image-2.5
  • gemini-3-pro-image / gemini-3.1-flash-image
  • nano-banana-pro-1k-1x1 / nano-banana-pro-2k-1x1 / nano-banana-pro-4k-1x1
  • flux-2 / flux-2-pro

2. 文生图（OpenAI Images） ​

curl ​

bash
curl -sS https://api.713812.xyz/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "产品摄影，白色背景，陶瓷咖啡杯，柔和侧光",
    "size": "1024x1024",
    "response_format": "url"
  }'

成功时 data[0].url 或 data[0].b64_json 为结果（取决于 response_format）。

Python（openai SDK） ​

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.713812.xyz/v1",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="赛博朋克雨夜街道，霓虹倒影，电影光效",
    size="1024x1024",
    response_format="url",
)
print(resp.data[0].url)

Node.js（openai SDK） ​

js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.713812.xyz/v1",
});

const resp = await client.images.generate({
  model: "gpt-image-2",
  prompt: "北欧客厅晨光，绿植与木地板，商业摄影",
  size: "1024x1024",
  response_format: "url",
});

console.log(resp.data[0].url);

3. 固定画幅模型（名称即分辨率） ​

部分模型 ID 已编码分辨率与比例，例如 nano-banana-pro-2k-16x9，请求体可省略复杂 size 配置：

bash
curl -sS https://api.713812.xyz/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro-2k-1x1",
    "prompt": "极简海报，大留白，中文标题「包菜大王」",
    "response_format": "url"
  }'

4. Gemini 风格多模态（可选） ​

适合垫图 / 换装等图文混合场景（若套餐已开通对应模型）：

bash
curl -sS "https://api.713812.xyz/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "电影质感，未来都市黄昏，宽银幕构图"}
      ]
    }],
    "generationConfig": {
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

5. 验收清单 ​

  1. GET /v1/models 能看到购买套餐内的图像模型。
  2. POST /v1/images/generations 返回 URL 或 b64，HTTP 200。
  3. 错误 Key → 401；空 prompt / 非法模型 → 400。
  4. 连续 3 次成功出图，总耗时在可接受范围（通常数十秒级）。

更多错误与限流见 错误码与限流。完整参数见 图像 API。