Docs & API

文档中心

这页不是给纯开发者炫技的，而是让你和你的客户都能快速知道：怎么拿 Key、怎么调用、怎么查结果、遇到问题去哪处理。

01先拿 Key

注册后先拿试用 Key，充值后再继续扩容。

02提交任务

图片和视频都走统一的 OpenAI 兼容入口。

03轮询查结果

结果支持保存，不需要用户理解底层异步逻辑。

04遇到问题

先看状态页，再去充值中心或工单中心处理。

接口示例

GPT Image 2 图片接口

适合零基础直接文生图，不会准备参考图也能先跑通。

curl -X POST "https://你的域名/api/v1/images/generations" \
  -H "Authorization: Bearer sk-mirror-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "黑金科技风发布会主视觉，主体清晰，金属反射，高级留白",
    "aspect_ratio": "1:1"
  }'

提交后会返回 task_id，再通过 /api/v1/images/results/:taskId 轮询结果。

接口示例

Nano Banana 2 图片接口

适合基于现有图片做升级、改图和风格统一。

curl -X POST "https://你的域名/api/v1/images/generations" \
  -H "Authorization: Bearer sk-mirror-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana2",
    "prompt": "保留主体结构不变，升级成黑金科技风，高级金属质感",
    "n": 1
  }'

如果你上传参考图或提供参考图链接，通常会更稳。

接口示例

Video Grok Imagine 视频接口

这是视频模型，不是文本模型，支持按秒生成并异步返回结果。

curl -X POST "https://你的域名/api/v1/videos/generations" \
  -H "Authorization: Bearer sk-mirror-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-grok-imagine",
    "prompt": "黑金科技风产品展示镜头，镜头缓慢推进，商业广告质感",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

结果通过 /api/v1/videos/results/:taskId 查询，支持 6 / 10 / 15 / 20 / 30 秒。

常用结果接口

轮询查询路线

图片结果查询/api/v1/images/results/:taskId

建议每 3 秒查询一次，结果会自动保存。

视频结果查询/api/v1/videos/results/:taskId

返回成功后，结果链接可直接在产品页内预览。

模型列表/api/v1/models

用于查看当前开放的在线能力。

常见错误

用户最容易遇到的 4 种情况

余额不足处理建议

请先去充值中心完成微信充值。

参数不完整处理建议

通常是漏填提示词、比例或任务号。

服务波动处理建议

说明当前服务暂时波动，可稍后再试。

任务不存在处理建议

可能是 task_id 填错，或任务已过期。