硅智开放接口文档

鉴权与约定

除健康检查、微信商户支付回调、部分推送验签外，请求需携带：

响应格式

{
  "ok": true,
  "message": "success",
  "data": { }
}

失败时 ok: false，并带 error / message。

选用原则

健康检查

微信登录

返回 openid / unionid / session_key 等；业务自行签发 JWT 或会话。session_key 仅建议用于虚拟支付签名，勿长期下发给客户端。

微信支付

预下单需 outTradeNo、amountFen、forwardNotifyUrl 等。商户回调打到本开放接口，再转发到业务 forwardNotifyUrl（见回调验签）。订单与结算存业务库。

AI 上游 / LLM

媒体生成走 /v1/ai/{platform}/…；文本对话走 /v1/llm/chat。业务自行保存 upstreamTaskId 与积分扣减。完整机器可读目录见 GET /v1/ai/platforms。

支持的平台

图片类 product

灵猫成本来自控制台通道卡片 ⚡ 价（2026-08-03）；实扣以任务 cost 为准。视频 / 音频（速创 video_*、audio_tts；典名 HappyHorse 等）同样走 submit/poll，product 见目录接口。

灵猫生图入参详解

统一入口：POST /v1/ai/lingmao/submit。请求体固定为 business（可空，默认 image）、product、payload。下方字段均写在 payload 内；网关会按 product 映射为上游 model + params。

1) gpt-image-2 · GPT Image 2

上游 model 同名。建议成本 ⚡0.0532/张。size 填像素尺寸（或 auto），不是 1:1 这种比例字符串。

{
  "business": "image",
  "product": "gpt-image-2",
  "payload": {
    "prompt": "一只戴眼镜的橘猫坐在窗台上看书",
    "size": "1024x1024",
    "quality": "auto",
    "images": ["https://example.com/ref.png"]
  }
}

2) nano-banana-2 · Nano Banana 2

上游 model：gemini-3.1-flash-image-preview。建议成本 ⚡0.1792/张。比例与清晰度拆成两个必填字段。

{
  "product": "nano-banana-2",
  "payload": {
    "prompt": "电商主图，白底产品特写",
    "aspectRatio": "3:4",
    "imageSize": "2K",
    "thinkingLevel": "minimal"
  }
}

3) nano-banana-pro · Nano Banana Pro

上游 model：gemini-3-pro-image-preview。建议成本 ⚡0.203/张。字段与 Banana 2 类似，但无超宽比例、无 0.5K。

{
  "product": "nano-banana-pro",
  "payload": {
    "prompt": "多语言海报，主标题居中，信息图排版",
    "aspectRatio": "9:16",
    "imageSize": "4K"
  }
}

4) midjourney · Midjourney

上游 model：mj_imagine（也可直接传 product mj_imagine）。建议成本 ⚡0.21/张。

{
  "product": "midjourney",
  "payload": {
    "prompt": "电影感夜景街道，霓虹倒影",
    "botType": "MID_JOURNEY",
    "aspectRatio": "16:9",
    "quality": "1",
    "stylize": "100",
    "chaos": "0",
    "style": "raw"
  }
}

5) wan2.6-image · 万相 2.6

上游 model 同名。建议成本 ⚡0.098/张。这里的 size 是宽高比（如 1:1），千万不要传 1024x1024。

{
  "product": "wan2.6-image",
  "payload": {
    "prompt": "参考图风格迁移到新场景",
    "size": "16:9",
    "prompt_extend": true,
    "images": ["https://example.com/style.png"]
  }
}

6) wan2.7-image · 万相 2.7

上游 model 同名。建议成本 ⚡0.14/张。size 同样是宽高比；另需质量档位。

{
  "product": "wan2.7-image",
  "payload": {
    "prompt": "中文海报，标题清晰可读",
    "quality": "pro",
    "size": "3:4"
  }
}

7) vidu-image-2 · VIDU Image 2

上游 model 同名。建议成本起 ⚡0.0241/张。比例、分辨率、质量三个字段都必填；空 params 会被上游拒绝。

{
  "product": "vidu-image-2",
  "payload": {
    "prompt": "IP 角色三视图，服装一致",
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "quality": "high",
    "images": ["https://example.com/char1.png", "https://example.com/char2.png"]
  }
}

文字类（LLM）

{
  "ok": true,
  "data": {
    "platforms": ["wuyin", "aa", "xiaojingai", "lingmao"],
    "media": [ { "platform": "lingmao", "products": [ … ] } ],
    "llm": [ { "provider": "deepseek", "models": ["deepseek-chat", "deepseek-reasoner"] } ]
  }
}

{
  "business": "image",
  "product": "gpt-image-2",
  "payload": { "prompt": "一只橘猫", "size": "auto", "quality": "auto" }
}

{
  "product": "nano-banana-2",
  "payload": { "prompt": "一只橘猫", "aspectRatio": "9:16", "imageSize": "2K" }
}

{
  "product": "wan2.7-image",
  "payload": { "prompt": "一只橘猫", "size": "1:1", "quality": "standard" }
}

{
  "product": "vidu-image-2",
  "payload": { "prompt": "一只橘猫", "aspect_ratio": "1:1", "resolution": "1K", "quality": "medium" }
}

{
  "provider": "deepseek",
  "model": "deepseek-chat",
  "messages": [{ "role": "user", "content": "你好" }]
}

Coze 工作流

配置来自主站 Coze 工作流表。无自动积分；调用方组装参数并解析 upstream 输出。

图片反推提示词

基于扣子工作流 image_prompt_reverse：上传风格参考图 URL，反推可用于生图的提示词。建议单次执行控制在 5 分钟内。

{
  "imageUrl": "https://cdn.example.com/style.jpg",
  "fileType": "image",
  "user_input": "偏日系清新，保留人物构图"
}

{
  "slug": "image_prompt_reverse",
  "mode": "sync",
  "body": {
    "image": {
      "url": "https://cdn.example.com/style.jpg",
      "file_type": "image"
    },
    "user_input": "偏日系清新，保留人物构图"
  }
}

七牛云

项目鉴权之外，使用业务自有七牛凭证，经 Header 传入（网关不落库）：

短信 / 滑动验证码

短信需额外传服务商 Header（X-Gz-Sms-Provider：tencent | aliyun | http 及对应 AK/模板等）。验证码流程一般为 issue → verify → consume（一次性）。

微信商家转账 / 消息推送

支付宝 / 上游余额

支付 / 转账回调验签

微信侧通知先到达本开放接口，再 POST 到你预下单时填写的 forwardNotifyUrl，并附加：

X-Gz-Signature: HMAC-SHA256(原始 body 字节, notify_secret)

notify_secret 在项目开通时生成，见后台下载的对接凭据文档。验签通过后再更新业务订单状态。

对接说明

1. 在管理后台开通开放接口项目，下载 对接凭据 .md（含密钥与本页链接）。
2. 将 Base URL 与 Header 配进业务环境变量即可；无需再维护独立 gz_apis 进程。
3. 按产品需要实现本页对应章节；未使用的能力可完全忽略。
4. Markdown 源文档位于主 API docs/open/；对外以本 HTML 为准。